版本比较

密钥

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。
说明

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

创建任务

通过 createTask方法 创建识别任务

请求节点:

状态
colourGreen
title国际节点
https://api.yescaptcha.com
状态
colourGreen
title国内节点
https://cn.yescaptcha.com

...

属性

类型

必须

说明

type

string

TurnstileTaskS2

状态
colourGreen
title15 POINTS
状态
colourRed
title需要传代理

TurnstileTaskProxyless

状态
title15 POINTS
->
状态
colourGreen
title25 POINTS

TurnstileTaskProxylessM1

状态
colourGreen
title30 POINTS

websiteURL

string

网页地址,一般固定值。

websiteKey

String

网站密钥,一般固定值。

proxy

String

TurnstileTaskS2 需要传代理

代理地址,支持以下格式:

  • 有密码http/https代理:http://user:pass@45.91.239.47:62930

  • 没有密码http/https代理:http://45.91.239.47:62930

  • 没有密码的socks5代理: socks5://5.252.190.52:64585

  • !不支持带密码的socks5代理!

注意:如果需要权限,请将43.154.193.54加入白名单

注意:CF盾对代理要求较高,请使用国际代理,如果报ERROR_CAPTCHA_UNSOLVABLE错误,请更换代理再试一下,也可以联系我们测试是否能过(绝大部份情况都能过)

注意:不要使用本地代理(127.0.0.1、localhost、192.168.x.x、172.0.x.x),本地代理只有你自己电脑才能访问,服务器访问不了!

...

代码块
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // 请记录此ID
}

获取结果

使用 getTaskResult 方法获取识别结果

请求节点:

状态
colourGreen
title国际节点
https://api.yescaptcha.com
状态
colourGreen
title国内节点
https://china.yescaptcha.com

...

代码块
{
    "clientKey":"cc9c18d3e263515c2c072b36a7125eecc078618f3",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

响应结果

参数

类型

说明

errorId

Integer

错误提示: 0 - 没有错误,1 - 有错误

errorCode

string

错误代码,点这里查看全部错误列表

errorDescription

string

错误详细描述

status

String

processing - 正在识别中,请3秒后重试
ready - 识别完成,在solution参数中找到结果

solution

Object

识别结果,不同类型的任务结果会有所区别。

gRecaptchaResponse

token

string

识别结果:response值。

识别结果:token值。

一次性使用,有效期120s,建议在60s内使用。

响应示例

代码块
languagejson
{
    "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了解出错误信息 🔗 全部错误说明