指南
如何使用

如何使用

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

第一步: 创建账号

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

第二步: 获取密钥

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

img

第三步: 创建任务

当你准备好密钥后,你可以通过 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 中的参数进行任务类型区分

  • 图片识别/语音识别
    • HCaptcha
    • ReCaptchaV2
    • AwsWAF
    • Voice Recognition
  • Captcha令牌
    • HCaptcha
    • 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"
}