Fetching image recognition result
When an image is submitted for recognition, it is queued to ensure a stable response even under high load. To obtain the result, send a GET request to the https://api.aspose.cloud/v5.0/ocr/RecognizeImage Aspose.OCR Cloud REST API endpoint. To authorize the request, pass the access token in Authorization header (Bearer authentication).
Provide the unique identifier of the recognition task in id parameter:
curl --request GET --location 'https://api.aspose.cloud/v5.0/ocr/RecognizeImage?id=c4b60313-4f78-45f8-b708-069eb98dc22e' \
--header 'Accept: text/plain' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...HaRYOxBcCRCPLnrFCVXpw7UA' \
Recognition results
The recognition result is returned in JSON format in the response body.
{
"id": "c4b60313-4f78-45f8-b708-069eb98dc22e",
"taskStatus": "Completed",
"responseStatusCode": "Ok",
"results": [
{
"type": "Text",
"data": "QWxsIG1lbiBsaXZlIGVudmVsb3BlZCBpbiB3aGFsZS1saW5lcy4="
}
],
"error": null
}
| Property | Type | Description |
|---|---|---|
id |
string | Unique identifier of the recognition task. Equals to the value of the id request property. |
taskStatus |
string | Current state of the recognition task in the queue. |
responseStatusCode |
string | Recognition response status. |
results |
array | Recognition results (depend on the resultType property of the recognition task).All results (including plain text) are returned as Base64 encoded strings. You must decode them to display on the screen or save to a file. |
error/messages |
string[] | Recognition error messages, if any. Even if the image is recognized, you can still get notifications and warnings about non-fatal recognition errors. |
Evaluation mode
To fetch the recognition result from evaluation request, send a GET request to the endpoint https://api.aspose.cloud/v5.0/ocr/RecognizeImageTrial?id={request ID}.
This endpoint does not use the Authorization header, so there is no need to generate an access token.
*). The sequence of masked words remains unchanged upon re-submitting the identical image for recognition.
Task statuses
Recognition may take up to several seconds depending on the Aspose.OCR cloud load and image size. The status of the recognition task is indicated in the taskStatus property of the recognition result.
| Status code | Description | To do |
|---|---|---|
| Pending | The image is queued for recognition, but not yet processed. | Try fetching the result in a couple of seconds using the same ID. |
| Processing | The image is currently recognized. | Fetch the result again using the same ID. |
| Completed | The image is recognized. | Read the recognition result from results property. |
| Error | An error occurred during recognition. | Check messages in the error property for more information. |
| NotExist | The request with the specified ID does not exist, or the result has already been deleted from the cloud storage. | Check the ID or send the image for recognition again with the same parameters. |