| Note |
|---|
通过 createTask方法 创建识别任务，然后通过 getTaskResult 方法 获取识别结果 |
创建任务
通过 createTask方法 创建识别任务
请求节点： https://api.ez-captcha.com
请求地址： https://api.ez-captcha/createTask
请求格式：POST application/json
| Info |
|---|
...
与 reCaptcha V2 不同在于，V3是无感识别，V3需要增加 pageAction 字段值（非必填）
如果你获得了无效的token,请联系我们,通常在我们优化之后都可以正常工作 |
立即查看在线代码示例！
任务类型
对于ReCaptcha V3的解决方案，我们提供的任务类型如下：
任务类型 | 描述 | 价格 | 价格(美元) | ||||||
|---|---|---|---|---|---|---|---|---|---|
ReCaptchaV3TaskProxyless | reCaptcha V3解决方案，使用服务器内置代理 |
| $0.8/1k | ||||||
ReCaptchaV3TaskProxylessS9 | reCaptcha V3高分值解决方案，使用服务器内置代理并使得返回的token分数至少为0.9 |
|
| $1.2/1k | ||||||
ReCaptchaV3EnterpriseTaskProxyless | reCaptcha V3Enterprise解决方案，使用服务器内置代理 |
|
对象结构
| $1.2/1k |
创建任务
通过 createTask方法 创建识别任务
请求节点： https://api.ez-captcha.com
请求地址： https://api.ez-captcha.com/createTask
中国优化地址：http://47.115.166.118:15000/createTask
请求格式：POST application/json
对象结构
注意：某些网站可能需要ua匹配，请直接使用我们指纹所用的ua，一般我们会跟随chrome版本进行更新
user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36
sec-ch-ua: "Chromium";v="128", "Not;A=Brand";v="24", "Google Chrome";v="128"
*如果您仍然获得无效的token，请联系我们。我们对其进行优化后，它通常会正常工作。
属性 | 类型 | 必须 | 说明 |
|---|---|---|---|
clientKey | string | 是 | 帐户密钥，可以在个人中心找到 |
task | object | 是 | 任务参数对象，详情为表格以下几项 |
type | string | 是 | 任务类型，如 ReCaptchaV3TaskProxyless |
websiteURL | string | 是 | ReCaptcha |
网页地址，一般固定值 | |||
websiteKey | String | 是 | ReCaptcha |
网站密钥，固定值 | |
isInvisible | Bool |
可选 | 对于reCaptcha V3类型， 该参数一般都为true，如果用户不提供，则默认自动设置为true |
pageAction | String |
否
此值必须正确，否则识别的结果大概率无效。🔗
...
可选 | 此值必须正确，否则识别的结果大概率无效 | ||
websiteTitle | string | 可选 | 加载recaptcha的网站页面，使用js控制台运行“document.title”获取title |
checkField | string | 可选 | reload 包中 protobuf 9的新值，可进行二次验证 |
请求示例
不要直接拿示例里面的pageAction来用！每个站的pageAction都不一样，参考此文章查找，传错了过不了！
| Code Block |
|---|
POST https://api.ez-captcha.com/createTask Host: api.ez-captcha.com Content-Type: application/json { "clientKey": "yourapiKeyyour clientkey", "task": { "typewebsiteURL":"RecaptchaV3TaskProxyless", "websiteURL":"https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php", "websiteKey": "6LdyC2cUAAAAACGuDKpXeDorzUDWXmdqeg-xy696", "pageActiontype": "examples/v3scoresReCaptchaV3TaskProxyless", "isInvisible": true, "pageAction": "examples/v3scores" } } |
响应示例
| Code Block |
|---|
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // 请记录此ID
} |
...
请求地址： https://api.ez-captcha.com/getTaskResult
中国优化地址：http://47.115.166.118:15000/getTaskResult
请求格式：POST application/json
根据系统负载，您将在 1s 到 10s 的时间间隔内得到结果
请求示例
| Code Block |
|---|
POST https://api.ez-captcha.com/getTaskResult
Content-Type: application/json
{
"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值，用于POST或模拟提交给目标网站。 |
一次性使用，有效期120s，建议在60s内使用。 |
响应示例
| Code Block |
|---|
{
"errorId": 0,
"errorCode": null,
"errorDescription": null,
"solution": {
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU......"
},
"status": "ready"
} |
...