createTask：创建任务

说明

该方法用于创建所选类型验证码的任务。参数中需要提供客户端认证信息、任务类型化数据，以及在必要时的额外参数。

方法地址

https://api.capmonster.cloud/createTask

请求格式：JSON POST

---

请求参数

clientKey

类型: String
必填: 是
您账户的唯一密钥，即 API 密钥（可在此处获取）

task

类型: 任务对象
必填: 是
任务数据对象。验证码任务类型列表见这里。

callbackUrl

类型: String
必填: 否
用于接收验证码任务结果的 Web 地址，结果通过 POST 请求发送。
内容与 getTaskResult 方法的响应相同。
响应内容不会被验证，服务器需在 2 秒内接收请求，然后关闭连接。

callbackUrl 使用示例：

{
  "clientKey": "API_KEY",
  "task": {
    "type": "RecaptchaV2Task",
    "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

类型: Integer
必填: 是
错误标识。
0 - 无错误，任务成功创建，任务 ID 在 taskId 参数中
1 - 出现错误，错误信息在 errorCode 属性中

errorCode

类型: String
必填: 否
错误代码。详见错误词汇表。

taskId

类型: Integer
必填: 是
任务 ID，用于后续调用 getTaskResult 方法获取结果。

---

响应示例

无错误响应

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

包含错误的响应

{
  "errorId": 1,
  "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
  "errorDescription": "Account authorization key not found in the system or has incorrect format",
  "taskId": 0
}