驾驶证识别V2

---

接口描述

通过光学字符识别技术，识别驾驶证的证件号、姓名、性别、国籍、住址、初次领证日期、准驾车型、有效日期等结构化数据.

请求说明

HTTP 方法:

POST

请求 URL：

/ai-cloud-face/ocr/v2/drivercard

Header如下：

参数名称	值
Content-Type	application/json;charset=UTF-8

Body中放置请求参数，参数详情如下：

请求参数：

参数名称	必填	数据类型	长度	参数描述
img	是	String	1-3000k	待处理图片(base64 编码)，原始图片大小需要小于 3M;
busFlowId	否	String	0-64	业务流水号，业务系统唯一序列号（对账用，建议传入）
getDetail	否	String	0-64	是否返回key-value格式详情 0：是 ，1：否 默认为1-否

请求示例：

{
    "img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......",
    "busFlowId":"xxxxxxxxxxxxxxxxx",
    "getDetail":"0"
}

返回说明

返回参数：

返回值名称	数据类型	长度	描述
code	String	1-8	返回结果，00000000表示成功
message	String	1-255	返回码描述
data	Object	-	返回的数据
-busFlowId	String	1-64	业务流水号，业务系统唯一序列号
-flowId	String	1-64	交易流水ID（建议保存）
-frontPage	Object	1-32	驾驶证正页信息
--cardNum	String	1-32	驾驶证号证件号
--name	String	1-32	姓名
--gender	String	1-4	性别
--nationality	String	1-4	国籍
--address	String	1-255	住址
--firstIssue	String	1-16	初次领证日期
--level	String	1-4	准驾车型
--birth	String	1-16	生日
--validdate1	String	1-16	有效期起始日期 yyyy-MM-dd
--validdate2	String	1-16	有效期截止日期 两种版式： 例如 n年或 yyyy-MM-dd
-sidePage	String	1-16	驾驶证副页信息
--cardNum	String	1-32	驾驶证号证件号
--name	String	1-32	姓名
--fileNumber	String	1-16	档案编号
--record	String	1-255	记录
-details	Object[]	1-16	字段详情信息，getDetail为0时返回该字段
--key	String	1-16	字段信息名称
--name	String	1-16	字段信息中文名称
--value	String	1-16	字段识别结果

返回示例：

驾驶证正页版式1：

{
    "message": "success",
    "code": "00000000",
    "success": true,
    "data": {
        "flowId":"xxxxxxxxx",
        "busFlowId":"xxxxxxxxxxxxxxxxx",
        "frontPage":{
            "address": "香港特别行政区湾仔高士打道108号3101室",
            "cardNum": "119411111111",
            "level": "C1",
            "firstIssue": "1998-01-07",
            "gender": "男",
            "name": "xxx",
            "nationality": "中国",
            "validdate1": "2011-01-07",
            "validdate2": "6年" 
        },
        "sidePage":{
            "name": "xxxx",
            "cardNum": "340111197806246013",
            "fileNumber": "511600001169",
            "record": "请于每个记分周期结束后三十日接受审验。无记分的，免予本次审验。"
        }
    }
}

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共CODE码表

码值	是否成功	是否计费	描述
00000000	是	是	成功
50028100	否	否	图片不能为空
50028103	否	否	图片大小不能超过3M
50028275	否	否	驾驶证识别异常
50028212	否	否	引擎检测异常
50028213	否	否	引擎检测异常