GeeTestTask: GeetestV3/V4 协议接口

TIP

通过 createTask 创建任务，然后通过 getTaskResult 获取识别结果

任务类型type如下

GeeTestTaskProxyLess

支持的图像类型

Type	Note	State
	滑块	stable
	图标点选	stable
	文字点选	stable
	消消乐	stable
	九宫格	stable
	五子棋	stable

创建任务

通过 createTask 创建任务。

参数结构

属性	类型	Required	说明
type	String	Yes	`GeeTestTask` `GeeTestTaskProxyLess`
websiteURL	String	Yes	网页所在URL
gt	String	Yes	三代必传
challenge	String	Yes	三代必传
captchaId	String	Yes	四代必传
geetestApiServerSubdomain	String	No	特定Api subdomain，可选

请求示例

GeeTest 三代请求参数

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

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type":"GeeTestTaskProxyLess",
        "websiteURL":"http://mywebsite.com/geetest/test.php", //所在页面的URL
        "gt":"...",
        "challenge":"...",
        "geetestApiServerSubdomain":"api.geetest.com", // 注意不要带`http://`和`/`
    }
}

GeeTest 四代请求参数

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

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type":"GeeTestTaskProxyLess",
        "websiteURL":"http://mywebsite.com/geetest/test.php",
        "captchaId": "..."
    }
}

响应示例

{
    "errorId": 0,
    "status": "idle",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

获取结果

使用 getTaskResult 方法获取识别结果，根据系统负载，您将在 3s 到 10s 的时间间隔内得到结果

请求示例

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

{
    "clientKey":"YOU_API_KEY",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

响应示例

如果你请求了3代你应该解析三代结果，如果是四代则需要解析四代结果

三代响应示例

{
  "errorId": 0,
  "solution": {
    "challenge": "",
    "validate": ""
  },
  "status": "ready"
}

四代响应示例

{
  "errorId": 0,
  "taskId": "e0ecaaa8-06f6-41fd-a02e-a0c79b957b15",
  "status": "ready",
  "solution": {
    "captcha_id": "",
    "captcha_output": "",
    "gen_time": "",
    "lot_number": "",
    "pass_token": "",
    "risk_type": "slide"
  }
}

使用 SDK 请求

#pip install --upgrade capsolver
#export CAPSOLVER_API_KEY='...'
 
import capsolver
# capsolver.api_key = "..."
# v3
solution = capsolver.solve({
        "type":"GeeTestTaskProxyLess",
        "websiteURL":"http://mywebsite.com/geetest/test.php", 
        "gt":"...", 
        "challenge":"...",
        "geetestApiServerSubdomain":"...", 
       })
       
# v4
solution = capsolver.solve({
         "type":"GeeTestTaskProxyLess",
        "websiteURL":"http://mywebsite.com/geetest/test.php", 
        "captchaId": "..."
       })

注意事项

请不要从浏览器开发者工具中直接复制,需要请求后获取 gt 和 challenge。
少量错误重新获取验证码参数重试即可。
验证码参数只能提交识别一次，切勿同样的参数重复提交识别，需要重新初始化获取。
四代中【注意事项：如遇无法通过可能是网站编码问题，则 captcha_output 的 =符号用%3D替换，其他无需编码，请注意该事项】。
测试服务端等参数可以在这里查询 Geetest文档。

AWS WAF reCAPTCHA v2