# 描述

检测和识别中华人民共和国机动车驾驶证（电子版）图像，并转化为结构化的文字信息。只可识别驾照正本(main sheet)正面和副本(second sheet)正面，一张照片最多可识别一个正本正面或一个副本正面。

● 电子驾照请传入手机截图，每个截图包含一张正页或一张副页。
● 图片最小 100*100 像素，图像长宽不得超过4096像素，否则会抛出错误。

# 调用URL

https://api.megvii.com/faceid/v3/ocr_e_driver_license

POST 注意：用form-data格式请求

参数

必选/可选	参数名	类型	参数说明
必选	sign	String	调用此API客户的签名，具体的签名产生方式请查阅鉴权
sign_version	String	签名算法版本号，请传递：hmac_sha1
image	String	一个图片，二进制文件，需要用Post Multipart/Form-Data的方式上传注：图像存储尺寸不能超过2MB，像素尺寸的长或宽都不能超过4096像素

必选/可选

参数名

类型

参数说明

必选

sign

String

调用此API客户的签名，具体的签名产生方式请查阅鉴权

sign_version

String

签名算法版本号，请传递：hmac_sha1

image

String

一个图片，二进制文件，需要用Post Multipart/Form-Data的方式上传

注：图像存储尺寸不能超过2MB，像素尺寸的长或宽都不能超过4096像素

返回值

字段	类型	说明
request_id	String	用于区分每一次请求的唯一的字符串。除非发生404（API_NOT_FOUND）或 403 （AUTHORIZATION_ERROR）错误，此字段必定返回。
page_classification	Int	0: 电子驾驶证正页 1：电子驾驶证副页 2：非电子驾驶证页面（非电子驾驶证页面则content内容返回空）
content_main	Object	电子驾驶证正页识别结构体，若page_classification=1或2，则不返回此字段
content_second	Object	电子驾驶证副页识别结构体，若page_classification=0或2，则不返回此字段
error_message	String	错误信息。
time_used	Int	当请求失败时才会返回此字符串，具体返回内容见后续错误信息章节。否则此字段不存在。整个请求所花费的时间，单位为毫秒。除非发生404（API_NOT_FOUND）或 403 （AUTHORIZATION_ERROR）错误，此字段必定返回。

content字段结构：

正页/副页	字段	类型	说明
content_main	name	String	持证人姓名
	vehicle_class	String	准驾车型
	score	String	累积记分
	date_first_issue	String	初次领证日期
	state	String	状态
	license_code	String	驾驶证号
	gender	String	性别
	date_birth	String	出生日期
	nationality	String	国籍
	archive_code	String	档案编号
	valid_from	String	有效期开始时间(YYYY-MM-DD)
	valid_to	String	有效期结束时间(YYYY-MM-DD)
	date_create	String	本次展示生成时间（YYYY-MM-DD）
content_second	address	String	地址
	issue_authority	String	发证机关
	record	String	记录

错误信息

HTTP 状态代码	错误信息	说明
400	IMAGE_ERROR_UNSUPPORTED_FORMAT	图像无法正确解析，有可能不是一个图像文件、或有数据破损。
400	INVALID_IMAGE_SIZE:	客户上传的图像像素尺寸的长或宽超过4096像素。对应图像太大的那个参数的名称。请注意：如果图片存储尺寸大于2MB，会触发错误413(Request Entity Too Large)。
400	MISSING_ARGUMENTS:	缺少某个必要参数。
403	AUTHORIZATION_ERROR:	api_key被停用、调用次数超限、没有调用此API的权限，或者没有以当前方式调用此API的权限取值： API_KEY_BE_DISCONTINUED：api_key被停用 IP_NOT_ALLOWED：不允许访问的IP（预留设计） LIMIT_REACHED：这个api_key对当前API的调用量达到上限。仅当api_key为测试key DENIED：无权限调用当前API EXPIRED_SIGN：签名已过期 INVALID_SIGN：无效签名其他可能的错误码，请预留处理方案
403	CONCURRENCY_LIMIT_EXCEEDED	并发数超过限制
404	API_NOT_FOUND	所调用的API不存在
413	Request Entity Too Large	客户发送的请求大小超过了2MB限制。该错误的返回格式为纯文本，不是json格式。
500	INTERNAL_ERROR	服务器内部错误，当此类错误发生时请再次请求，如果一直出现此类错误，请及时联系客服。