/ocr/indian_dl

1.API Specification
2.Request Params
3.Response Params
4.Error Codes
5.Sample

1.API Specification

This API is used to recognize Indian driving license, and extract the key information.

Driving License (1 call) - Front

States Coverage：

  1. BIHAR STATE
  2. DELHI STATE
  3. KARNATAKA STATE
  4. MADHYA PRADESH STATE
  5. PUNJAB STATE
  6. RAJASTHAN STATE

Image spec

1. Format: JPG(JPEG), PNG
2. Between 128*128 and 6000*6000 (pixels), Recommended resolution: 1280*1280
3. File size: no larger than 5 MB

Request Method

POST

Request URL

https://cloudapi.accuauth.in/ocr/indian_dl

Debugging Tool

Debugging Tool

2.Request Params

2.1 Request Header

Parameter Type Required Description
X-DF-API-ID string Yes For API credentials，Please visit API Request
X-DF-API-SECRET string Yes For API credentials，Please visit API Request

2.2 Request Body

Fields Type Description
optional file file Binary data of the image
optional image_base64 string Base64 encoded data of image
optional detect_image_quality int Image quality detection option, 1: enable, 0: disable. API will return the detect_image_quality field if the above mentioned value is enabled.

Either parameter file or image_base64 must be provided as a request parameter.

You MUST add image stream to multipart/form-data section of POST message when using file parameter.

3.Response Params

Fields Type Description
request_id string Unique id of each request
status string Response status, OK for success request, Error Codes for failed request
image_quality float Image quality score [0.0-1.0], the greater of the value the higher image quality
results array The array of ocr results; See results

3.1 Elements in results:

Fields Type Description
card_side string The side: front,back
card_info object The key infomation of driving license; See card_info

3.2 Elements in the card_info

Fields Type Description
card_id string Number of Driving License
name string Name of card holder
dob string Date of birth
Response Syntax
{
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
  "status": "OK",
  "image_quality": 0.771,
  "results": [{
     "card_side": "front",
     "card_info":{
       "card_id": "DLXXXXXXXXX",
       "name": "DHARAM XXX",
       "dob": "01/04/1994"
      }
  }]
}

4.Error Codes

Common error codes of this API:

Http Status Code Status Field Description
400 INVALID_ARGUMENT Request parameter is invalid
400 DETECTION_FAILED Detect image failed
401 UNAUTHORIZED Unauthorized or access is denied
401 KEY_EXPIRED Your API ID has expired
403 NO_PERMISSION You are not authorized to use this API
403 OUT_OF_QUOTA API calls quota exceeded
403 RATE_LIMIT_EXCEEDED API request frequency exceeds the limit
404 NOT_FOUND Requested API cannot be found
500 INTERNAL_ERROR Internal server error

Comment: Please see the reason field for details when the above 40X error occurred

Response Syntax
{
  "status": "INVALID_ARGUMENT",
  "reason": "must specify 'file' or 'image_base64' argument",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.Sample

results matching ""

    No results matching ""