createTask : captcha task creating

Description

This method creates a task for solving selected captcha type. In the parameters you need to pass the client authorization data, typed task data and other optional parameters.

Method address: https://api.capmonster.cloud/createTask
Request format: JSON POST


Request parameters

Parameter

Type

Required

Purpose

Parameter

Type

Required

Purpose

clientKey

String

Yes

Client API key. You can get it here.

task

Task type object

Yes

Task data. See list of available object descriptions here.

callbackUrl

String

No

Optional web address where we will send result of captcha task processing. Contents are sent by POST request and are same to the contents of getTaskResult method. The content of the response is not checked and you must accept the request in 2 seconds then the connection will be closed.

Request examples

{ "clientKey":"67b6bcbb1a728ea8d563de6d169a2057", "task": { "type":"ImageToTextTask", "body":"BASE64_BODY_HERE!" } }
{ "clientKey":"67b6bcbb1a728ea8d563de6d169a2057", "task": { "type":"NoCaptchaTaskProxyless", "websiteURL":"https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high", "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd" } }

Response structure

Parameter

Type

Purpose

Parameter

Type

Purpose

errorId

Integer

Error identificator.

0 - no errors, the task has been successfully created, task ID located in taskId property

1 - error, information about it is in the errorCode property

errorCode

String

Error code. Check out errors list.

taskId

Integer

Task ID for future use in getTaskResult method.

Response example

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