如何使用

你可以通过如下步骤，学会如何使用CapSolver的服务

第一步: 创建账号

当你准备好使用CapSolver 的服务之前，你需要到用户面板进行账号注册。你可以选择多种方式注册，如果你没有看到你想要的注册方式请联系我们。

第二步: 获取密钥

当你注册成功后，你可以在首页面板中获取得到请求API的令牌

第三步: 创建任务

当你准备好密钥后，你可以通过 createTask 我们的http接口进行任务的创建，下面将演示一个http请求的参数案例。

请求协议 headers

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV2TaskProxyLess",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    //support cookies
    "cookies": [
      {
        "name": "__Secure-3PSID",
        "value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozgwfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
      },
      {
        "name": "__Secure-3PAPISID",
        "value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"
      }
    ]
  }
}

当你的账户有充足的余额并参数无误的请求发送后，你将得到如下api接口结果响应

{
  "errorId": 0,
  "errorCode": "",
  "errorDescription": "",
  // 请记录此ID,后续查询任务结果会使用到
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

我们目前支持的任务分多种类型，你可以使用 task > type 中的参数进行任务类型区分

图片识别/语音识别
- ReCaptchaV2
- AwsWAF
- Voice Recognition
Captcha令牌
- GeeTest
  - MtCaptcha
- ReCaptchaV2
- ReCaptchaV3

第四步: 获取任务执行结果

通常识别任务返回结果是直接通过 createTask 返回的，但令牌任务执行需要花费较多的时间，所以你需要单独通过 getTaskResult 获取任务结果。

请求协议 headers

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json

{
  "clientKey": "YOUR_API_KEY",
  //第一步createTask返回的结果
  "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4"
}

一般只需要等待 1-10s 你将可以通过 getTaskResult 获取到任务执行结果，下面是一个成功的响应当你的账户有充足的余额并参数无误的请求发送后，你将得到如下api接口结果响应

{
  "errorId": 0,
  "solution": {
    "userAgent": "xxx",
    "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
  },
  "status": "ready"
}

什么是Capsolver?任务类型