创建一个验证码识别任务,在参数里面指定识别哪一种验证码。
请求节点: https://api.ez-captcha.com
请求地址: https://api.ez-captcha.com/createTask
请求格式:POST
application/json
任务类型
类型 | 描述 | 价格 |
---|---|---|
ReCaptchaV2TaskProxyless | reCaptcha V2解决方案,使用服务器内置代理 | 6 POINTS |
ReCaptchaV2TaskProxylessS9 | reCaptcha V2高分值解决方案,使用服务器内置代理并使得返回的token分数至少为0.9 | 12 POINTS |
ReCaptchaV2EnterpriseTaskProxyless | reCaptcha V2Enterprise解决方案,使用服务器内置代理 | 18 POINTS |
ReCaptchaV2STaskProxyless | reCaptcha V2带s参数解决方案,,使用服务器内置代理 | 15 POINTS |
ReCaptchaV2SEnterpriseTaskProxyless | reCaptcha V2Enterprise带s参数解决方案,使用服务器内置代理 | 30 POINTS |
ReCaptchaV3TaskProxyless | reCaptcha V3解决方案,使用服务器内置代理 | 8 POINTS |
ReCaptchaV3TaskProxylessS9 | reCaptcha V3高分值解决方案,使用服务器内置代理并使得返回的token分数至少为0.9 | 15 POINTS |
ReCaptchaV3EnterpriseTaskProxyless | reCaptcha V3Enterprise解决方案,使用服务器内置代理 | 18 POINTS |
请求参数
以ReCaptcha为例,其他类型Captcha请查看对应的具体文档
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
clientKey | string | 是 | 帐户密钥,可以在个人中心找到 |
task | object | 是 | 任务参数对象,详情为表格以下几项 |
type | string | 是 | 任务类型,如 ReCaptchaV2TaskProxyless |
websiteURL | string | 是 | ReCaptcha 网页地址,一般固定值 |
websiteKey | string | 是 | ReCaptcha 网站密钥,固定值 |
isInvisible | Bool | 否 | 对于reCaptcha V2类型,遇到invisible类型的reCaptchaV2需要添加此参数并设置为true,该参数不填时默认为false。对于reCaptcha V3类型, 该参数默认为true |
pageAction | string | 否 | 该参数只针对于reCaptcha V3,一般都需要填写,如果不填默认会使用空参数,会很大程度上影响通过率 |
s | string | 否 | 只用于解决带s参数的reCaptcha V2,包括V2和V2 Enterprise,需要将类型指定为ReCaptchaV2STaskProxyless或RecaptchaV2SEnterpriseTaskProxyless,从你所使用的网站中返回的数据包中找到该参数并设置。 |
请求示例:
ReCaptcha V3
POST https://api.ez-captcha.com/createTask Content-Type: application/json { "clientKey":"yourapiKey", "task": { "type":"ReCaptchaV3TaskProxyless", "websiteURL":"https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php", "websiteKey":"6LdyC2cUAAAAACGuDKpXeDorzUDWXmdqeg-xy696", "pageAction": "examples/v3scores", "isInvisible": true } }
响应数据
参数 | 类型 | 说明 |
---|---|---|
errorId | Integer | 错误提示: 0 - 没有错误,1 - 有错误 |
errorCode | string | 错误代码 |
errorDescription | string | 错误详细描述 |
taskId | string | 创建的任务ID,使用 getTaskResult 接口获取识别结果 |
响应示例
{ "errorId": 0, "errorCode": "", "errorDescription": "", "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b" // 请记录此ID,供下一步使用 }