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文档。