createTask: create a captcha task

This method creates a task for solving a chosen captcha type.

Address: https://api.ocrdatasolutions.com/createTask
Method: POST
Content-type: application-json

Request properties

PropertyTypeRequiredPurpose
clientKeyStringYesClient account key
taskObjectYesTask object.
softIdIntegerNoID of your application from our Developers Center. If you build an app, you can earn 10% of what your app users spend. By posting each captcha with your registered app ID, you’re telling the system where to send your commission.
languagePoolStringNoSets workers’ pool language. Only applies to image captchas. At the moment, the following language pools are available:

en (default): English language queue
rn: group of countries: Russia, Ukraine, Belarus, Kazakhstan
callbackUrlStringNoOptional web address where we can send the results of captcha task processing. Contents are sent by AJAX POST request and are similar to the contents of getTaskResult method.

Request example

curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "task":
        {
            "type":"NoCaptchaTaskProxyless",
            "websiteURL":"http://makeawebsitehub.com/recaptcha/test.php",
            "websiteKey":"6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ"
        },
    "softId":0,
    "languagePool":"en"
}' https://api.ocrdatasolutions.com/createTask

Response structure

PropertyTypePurpose
errorIdIntegerError identifier. 0 – no errors, operation completed successfully.
>1 – error identifier. Error code and short description transferred in errorCode and errorDescription properties.
errorCodeStringAn error code, won’t be included in the output if request produced no errors. See errors list for reference.
errorDescriptionStringShort description of the error
taskIdIntegerTask ID that you should later use in the getTaskResult method

Response example

JSON with no errors

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

JSON with an error

{
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}