createTask:创建任务
说明
该方法用于创建所选类型验证码的任务。参数中需要提供客户端认证信息、任务类型化数据,以及在必要时的额外参数。
方法地址
https://api.capmonster.cloud/createTask
请求格式:JSON POST
请求参数
clientKey
类型: String
必填: 是
您账户的唯一密钥,即 API 密钥(可在此处获取)
task
类型: 任务对象
必填: 是
任务数据对象。验证码任务类型列表见这里。
callbackUrl
类型: String
必填: 否
用于接收验证码任务结果的 Web 地址,结果通过 POST 请求发送:完成的任务解决方案会发送到该地址,因此无需再轮询 getTaskResult 方法。
请求正文包含 getTaskResult 响应的字段,包括 solution(任务解决方案)和 cost(解决费用,单位为美元,USD),此外还有 taskId 字段(类型为 String,任务标识符)。
响应内容不会被验证,服务器需在 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"
}
CapMonster Cloud 发送到 callbackUrl 的请求正文示例(solution - 任务解决方案,cost - 解决费用,单位为 USD):
{
"solution": {
"text": "answer"
},
"cost": 0.0003,
"status": "ready",
"taskId": "7654321",
"errorId": 0,
"errorCode": null,
"errorDescription": null
}
请求示例
图像验证码任务示例
{
"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
}
