通过 createTask方法 创建识别任务，然后通过 getTaskResult 方法 获取识别结果
创建任务
通过 createTask方法 创建识别任务
请求节点： 国际节点 https://api.yescaptcha.com 国内节点 https://cn.yescaptcha.com
请求地址： https://api.yescaptcha.com/createTask
请求格式：POST application/json
对象结构
属性 | 类型 | 必须 | 说明 |
|---|---|---|---|
type | string | 是 | TurnstileTaskS2 15 POINTS 需要传代理 TurnstileTaskProxyless 15 POINTS -> 25 POINTS TurnstileTaskProxylessM1 30 POINTS |
websiteURL | string | 是 | 网页地址，一般固定值。 |
websiteKey | String | 是 | 网站密钥，一般固定值。 |
proxy | String | 否 | TurnstileTaskS2 需要传代理 代理地址，支持以下格式：
注意：如果需要权限，请将 注意：CF盾对代理要求较高，请使用国际代理，如果报ERROR_CAPTCHA_UNSOLVABLE错误，请更换代理再试一下，也可以联系我们测试是否能过（绝大部份情况都能过） 注意：不要使用本地代理（127.0.0.1、localhost、192.168.x.x、172.0.x.x），本地代理只有你自己电脑才能访问，服务器访问不了！ |
请求示例
{
"clientKey":"cc9c18d3e263515c2c072b36a7125eecc078618f",
"task":
{
"type":"TurnstileTaskProxyless",
"websiteURL":"https://react-turnstile.vercel.app",
"websiteKey":"1x00000000000000000000AA"
}
}
响应示例
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // 请记录此ID
}
获取结果
使用 getTaskResult 方法获取识别结果
请求节点： 国际节点 https://api.yescaptcha.com 国内节点 https://china.yescaptcha.com
请求地址： https://api.yescaptcha.com/getTaskResult
请求格式：POST application/json
根据系统负载，您将在 10s 到 80s 的时间间隔内得到结果
请求示例
{
"clientKey":"cc9c18d3e263515c2c072b36a7125eecc078618f3",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
响应结果
参数 | 类型 | 说明 |
|---|---|---|
errorId | Integer | 错误提示： 0 - 没有错误，1 - 有错误 |
errorCode | string | 错误代码，点这里查看全部错误列表 |
errorDescription | string | 错误详细描述 |
status | String | processing - 正在识别中，请3秒后重试 |
solution | Object | 识别结果，不同类型的任务结果会有所区别。 |
gRecaptchaResponse | string | 识别结果：response值。 一次性使用，有效期120s，建议在60s内使用。 |
响应示例
{
"errorId": 0,
"errorCode": null,
"errorDescription": null,
"solution": {
"token": "0.ufq5RgSVZd11DPSX1brdrxnEs28KcVlKj2ORchqxSy2q9yAW6ciq3hriXDF4x……",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36",
},
"status": "ready"
}
响应说明
识别成功：当
errorId等于0并且status等于ready，结果在solution里面。正在识别中：当
errorId等于0并且status等于processing，请3秒后重试。出错了：当
errorId大于0，请根据errorDescription了解出错误信息 🔗 全部错误说明