接口描述

针对驾驶证主页图片，进行OCR检测，返回检测到的驾驶证号、姓名、性别、国籍、住址、出生日期、初次领证日期、准驾车型、有效期限。驾驶证识别只支持主页识别。

备注：接口只允许单张图片请求，不允许图片list。

请求方法

POST

接口要求

• 目前仅支持 base64 编码方式请求，一次请求仅支持一条数据。
• 图片格式限制：目前仅支持 jpg、jpeg、png、bmp 格式。
• 图片大小限制：base64 编码后，图片大小不超过 7 MB。
• 图片尺寸限制：图片像素尺寸应不小于 32x32，不大于 5000x5000。

请求URI

/v1/aiop/api/3131mkjqbqck/driver-lisence/ocr/detect

请求参数

1.请求头header参数

2.请求体body参数

请求代码示例

Curl -X POST
"https://ai-global.ctapi.ctyun.cn/v1/aiop/api/3131mkjqbqck/driver-lisence/ocr/detect"
-H "Content-Type: application/json"
-H "ctyun-eop-request-id:33dfa732-b27b-464f-b15a-21ed6845afd5"
-H "appkey:XXX"
-H "Eop-Authorization:XXX"
-H "eop-date:20211109T104641Z"
-H "host:ai-global.ctapi.ctyun.cn"
--data '{"Action": "DriversLicense","ImageData": "_9j_4AAQSkZJRgA..."}'

返回值说明

1.请求成功返回响应参数

表returnObj

2.请求失败返回响应参数

返回值示例

1.请求成功返回值示例

{
    "statusCode": 0,
    "message": "success",
    "returnObj": {
        "No": "3101151992XX24XXXX",
        "name": "刘XX",
        "sex": "男",
        "nation": "中国",
        "address": "上海市长宁区XXX路900号",
        "date_birth": "1992-12-24",
        "date_first": "2020-10-25",
        "class": "C1",
        "period": "2020-10-25至2026-10-25"
    }
}

2.请求失败返回值示例

{
    "statusCode": 400003,
    "message": "body内容为空", 
    "details": "Body请求数据为空，没有包含内容"
}

状态码

错误码说明

6 位错误码。4 开头为业务错误码，5 开头为服务错误码。

base64 编码规则：使用常规的 safe base64 编码方式

• python 中推荐使用 base64.urlsafe_b64encode() 函数进行编码。
• java 中推荐使用 BASE64.getUrlEncoder().encodeToString() 函数进行编码。