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
Property | Type | Required | Purpose |
---|---|---|---|
clientKey | String | Yes | Client account key |
task | Object | Yes | Task object. |
softId | Integer | No | ID 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. |
languagePool | String | No | Sets 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 |
callbackUrl | String | No | Optional 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
Property | Type | Purpose |
---|---|---|
errorId | Integer | Error identifier. 0 – no errors, operation completed successfully. >1 – error identifier. Error code and short description transferred in errorCode and errorDescription properties. |
errorCode | String | An error code, won’t be included in the output if request produced no errors. See errors list for reference. |
errorDescription | String | Short description of the error |
taskId | Integer | Task 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"
}