/ocr/driving_license

1.接口描述

该 API 用于识别静态驾驶证图像上的文字信息。

• 图片要求：
  1. 格式为 JPG（JPEG），BMP，PNG，GIF，TIFF
  2. 宽和高大于 8px，小于等于 4000px
  3. 小于等于 5 MB

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/ocr/driving_license

2.请求参数

请求参数 file,url与 image_id 必须选择其中的一个。

url 中含有不少特殊字符，若将 URL 放入 Query String 中则需要对这些字符进行转义，所有中文和特殊字符必需以UTF-8编码转义。 目前支持 http/https 等协议的网络地址。下载限时 5s，超时后仍未下载完成则属于失败。 参数 file 需把图片文件的内容以 multipart/form-data 的形式放到 POST 消息体中。

3.返回参数

result 数组中字段的结构为：

驾驶证识别结果示例

version: 1 时返回结果

{
    "request_id": "TID5685a175fb4e4197b3123ff7731ef81f",
    "status": "OK",
    "ocr_status": "OK",
    "image_id": "ac65786ded0c43a6a086d3736b53f36d",
    "result": {
        "valid_from": "2013-02-15",
        "gender": "男",
        "issued_by": "湖南省********",
        "issue_date": "2013-02-15",
        "class": "C1",
        "license_number": "430522199*******",
        "valid_for": "6年",
        "birthday": "1990-09-25",
        "version": 1,
        "address": "湖南省********",
        "nationality": "中国",
        "side": "front",
        "name": "何**"
    }

version: 2 时返回结果

{
    "request_id": "TID5685a175fb4e4197b3123ff7731ef81f",
    "status": "OK",
    "ocr_status": "OK",
    "image_id": "ac65786ded0c43a6a086d3736b53f36d",
    "result": {
        "valid_date": "2013-02-15 至 2019-02-15"
        "valid_from": "2013-02-15",
        "gender": "男",
        "issued_by": "湖南省********",
        "issue_date": "2013-02-15",
        "class": "C1",
        "license_number": "430522199*******",
        "valid_for": "2019-02-15",
        "birthday": "1990-09-25",
        "version": 1,
        "address": "湖南省********",
        "nationality": "中国",
        "side": "front",
        "name": "何**"
    }
}

4.错误码

输出样例

{
  "status": "INVALID_ARGUMENT",
  "reason": "must specify 'image_id', 'file' or 'url' argument",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.输入示例

• cURL 样例

curl -X POST "https://cloudapi.linkface.cn/ocr/driving_license?api_id=ID&api_secret=SECRET" \
  -F file=@/PATH/TO/IMAGE

• HTTPie 样例

http -f POST "https://cloudapi.linkface.cn/ocr/driving_license?api_id=ID&api_secret=SECRET" \
  file@/PATH/TO/IMAGE