createTask：创建任务

创建一个验证码识别任务，在参数里面指定识别哪一种验证码。

请求地址： https://api.ez-captcha.com/createTask

中国优化地址：http://47.115.166.118:15000/createTask

请求格式：POST application/json

任务类型

类型	描述

类型	描述
ReCaptchaV2TaskProxyless	reCaptcha V2解决方案，使用服务器内置代理
ReCaptchaV2TaskProxylessS9	reCaptcha V2高分值解决方案，使用服务器内置代理并使得返回的token分数至少为0.9
ReCaptchaV2EnterpriseTaskProxyless	reCaptcha V2Enterprise解决方案，使用服务器内置代理
ReCaptchaV2STaskProxyless	reCaptcha V2带s参数解决方案，，使用服务器内置代理
ReCaptchaV2SEnterpriseTaskProxyless	reCaptcha V2Enterprise带s参数解决方案，使用服务器内置代理
ReCaptchaV3TaskProxyless	reCaptcha V3解决方案，使用服务器内置代理
ReCaptchaV3TaskProxylessS9	reCaptcha V3高分值解决方案，使用服务器内置代理并使得返回的token分数至少为0.9
ReCaptchaV3EnterpriseTaskProxyless	reCaptcha V3Enterprise解决方案，使用服务器内置代理

请求参数

以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，供下一步使用
}