最近更新时间：2021.12.16 13:59:15
首次发布时间：2021.12.16 13:59:15
请先查看接入指引了解具体接入方式，再参考此文档完成接入。
| 名称 | 内容 |
|---|---|
| 请求方式 | POST |
| Content-Type | application/x-www-form-urlencoded |
| 是否需要鉴权 | 是 |
| 图片要求 | 1. 图片格式：JPG、JPEG、PNG、BMP等常见格式，建议使用JPG格式。 2. 图片像素尺寸：为了保证文字识别效果，推荐图片中驾驶证最短边长不低于256像素。 3. 图片文件大小：最大 4 MB。驾驶证主体尽量占据图片主要区域。 4. 注意图片质量：保证驾驶证图片足够清晰，不应该有因为压缩导致的噪声，避免对驾驶证正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。 5. 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。 6. 驾驶证图片不可以是复印件、翻拍件、PS件等。 |
Query参数：
| 参数 | 可选/必选 | 类型 | 说明 |
|---|---|---|---|
| Action | 必选 | String | 接口名，取值：DrivingLicense |
| Version | 必选 | String | 版本号，取值：2020-08-26 |
Body参数：
| 参数 | 可选/必选 | 类型 | 说明 |
|---|---|---|---|
| image_base64 | 必选 | String | 驾驶证图片文件，base64编码 |
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| license_main | main_info | 主页面信息 | 字段说明见下方 |
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| id_number | String | 证号 | 主页信息 |
| name | String | 姓名 | 主页信息 |
| sex | String | 性别 | 主页信息 |
| nationality | String | 国籍 | 主页信息 |
| address | String | 住址 | 主页信息 |
| date_of_birth | String | 出生日期 | 主页信息 |
| date_of_first_issue | String | 初次领证日期 | 主页信息 |
| class | String | 准驾车型 | 主页信息 |
| valid_begin | String | 有效期起 | 主页信息 |
| valid_end | String | 有效期止 | 主页信息 |
| HttpCode | 错误码 | 错误消息 | 描述 |
|---|---|---|---|
| 200 | 10000 | 无 | 请求成功 |
| 400 | 60503 | "Invalid Input Image: No driving license detected in input image, bad input image" | 输入图片没有检测到驾驶证 |
| 401 | 50205 | "Image Size Exceeds Maximum Limit: please compress the image" | 图片大小超过上限 |
| 400 | 50207 | "Image Decode Error: image format unsupported" | 图片解码错误，文件内容为空或格式错误 |
| 401 | 50400 | "Access denied due to invalid authentication information" | 鉴权失败 |
| 404 | 50402 | "Invalid Request URL" | 无效的请求路径 |
| 500 | 50500 | "Internal Error: please contact with bytedance engineering team" | 内部错误，需要联系开发人员 |
注: 更多通用反馈字段通用返回字段及错误码
{ "code":10000, "data":{ "license_main":{ "id_number":"370XXX19000101XXXX", "name":"张三", "sex":"女", "nationality":"中国", "address":"山东省XX市XX镇XX村XX", "date_of_birth":"1900-01-01", "date_of_first_issue":"2016-01-01", "class":"C1", "valid_begin":"2016-01-01", "valid_end":"2022-01-01" } }, "message":"Success", "request_id":"68465821727368171521594094134", "time_elapsed":"509.475088ms" }