getTaskResult: request a task result

Pull a captcha task status previously created using the createTask method

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

Request properties

PropertyTypeRequiredPurpose
clientKeyStringYesClient account key
taskIdIntegerYes
An identifier obtained in the createTask method

Request example

curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "taskId":12345
}' https://api.ocrdatasolutions.com/getTaskResult

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
statusStringprocessing – the task is not ready yet
ready – the task is complete; you’ll find a solution in the solution property
solutionObjectTask result data. Different for each type of task.
costDoubleCost of the task in USD.
ipStringIP from which the task was created.
createTimeIntegerUNIX timestamp date of task creation.
endTimeIntegerUNIX timestamp date of task completion.
solveCountIntegerNumber of workers who tried to complete your task

Response example

JSON with no errors

{
    "errorId":0,
    "status":"ready",
    "solution":
        {
            "text":"deditur",
            "url":"http:\/\/61.39.233.233\/1\/147220556452507.jpg"
        },
    "cost":"0.000700",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}

JSON with an error

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