createTask：创建任务

描述

此方法用于创建解决所选验证码类型的任务。在参数中，您需要传递客户端授权数据、任务数据和其他可选参数。

方法地址

https://api.capmonster.cloud/createTask

请求格式：JSON POST

---

请求参数

clientKey

类型：字符串
必填：是
您的唯一账户密钥，API密钥（您可以在这里找到）

task

类型：任务对象
必填：是
任务数据数组。查看可用对象描述的列表这里。

callbackUrl

类型：字符串
必填：否
用于接收验证码任务结果的网址。数据通过POST请求发送。
内容与 getTaskResult 方法的响应相同。
响应内容不进行检查，服务器必须在2秒内接受请求，然后关闭连接。

以下是使用 callbackUrl 函数的示例：

{
  "clientKey": "API_KEY",
  "task": {
    "type": "NoCaptchaTaskProxyless",
    "websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
    "websiteKey": "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  },
  "callbackUrl": "https://yourwebsite.com/callback"
}

---

请求示例

解决带图像的普通验证码

    {
      "clientKey":"API_KEY",
      "task": 
      {
        "type":"ImageToTextTask",
        "body":"BASE64_BODY_HERE!"
      }
    }

解决 ReCaptcha2

{
      "clientKey":"API_KEY",
      "task": 
      {
        "type":"RecaptchaV2Task",
        "websiteURL":"https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
        "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
      }
    }

---

响应结构

errorId

类型：整数
必填：是
错误标识符。
0 - 没有错误，任务已成功创建，任务ID位于 taskId 属性中
1 - 发生错误，有关错误的信息在 errorCode 属性中

errorCode

类型：字符串
必填：否
错误代码。查看错误列表。

taskId

类型：整数
必填：是
T任务ID，用于后续在 getTaskResult 方法中使用。

---

响应示例

无任何错误的响应

{
      "errorId": 0,
      "taskId": 7654321
    }

有错误的响应

{
        "errorId": 1,
        "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
        "errorDescription": "系统中找不到账户授权密钥，或其格式不正确",
        "taskId": 0
    }