驾驶证OCR
接口描述
- 上传驾驶证照片，并进行证件信息识别
- 图片类型支持：jpg，jpeg，png，bmp
- 图片建议1024*768，24位深度，图片大小在600k以内
接口地址
/v2/identity/auth/api/ocr/drivinglicence
请求方式
- POST
- 请求报文体采用Json数据格式，编码方式采用UTF-8编码
请求参数
| 参数名 | 说明 | 参数类型 | 是否必填 | 类型 |
|---|---|---|---|---|
| image | 驾驶证图片BASE64字符串，注意不要带图片BASE64前缀“data:image/jpeg;base64,”，最大7MB | body | 是 | string |
| requestId | 标识一次客户的请求，允许为空，一般使用客户的业务id | body | 否 | string |
请求示例
POST /v2/identity/auth/api/ocr/drivinglicence HTTP/1.1
{
"requestId":"123",
"image": "/9j/4AAQSkZJRgABAQEAS......"
}
响应参数
| 参数名 | 说明 | 类型 |
|---|---|---|
| code | int | 接口响应结果码 |
| message | string | 接口响应结果描述 |
| data | object | 接口响应结果数据 |
| verifyId | string | 业务Id |
| name | string | 名称 |
| number | string | 驾驶证号 |
| type | string | 证件类型 |
| address | string | 持证人住址 |
| nationality | string | 持证人国籍 |
| sex | string | 性别 |
| birthday | string | 持证人出生年月日 |
| validTime | string | 驾驶证有效期 |
| driveType | string | 准驾车型 |
响应示例
{
"code": 0,
"message": "成功",
"data": {
"verifyId": "8644b137-c7f7-4994-ac71-01bc4e7042a2",
"birthday": "1981-04-10",
"sex": "男",
"address": "福建省福州市鼓楼区",
"nationality": "中国",
"name": "林剑辉",
"validTime": "2011-05-31至2021-05-31",
"driveType": "A1A2",
"type": "中华人民共和国机动车驾驶证",
"number": "350102198104181X"
}
}
错误码
| 错误码 | 错误信息 | 错误原因 |
|---|---|---|
| 30500101 | 参数错误：image不能为空 | 图片BASE64字符串为空 |
| 30500101 | 参数错误：文件大小超出限制，最大7MB | 图片大小超过限制 |
| 30503127 | OCR识别失败 | OCR识别失败 |