# 版本

5.0.0

# 描述

检测和识别中华人民共和国机动车行驶证（以下称“行驶证”）图像为结构化的文字信息。支持行驶证主页正面，行驶证副页正面。

● 行驶证图像须为正拍（垂直角度拍摄），但是允许有一定程度的旋转角度；
● 图像长宽不得超过4096像素，否则会抛出错误。
● 仅支持图像里有一个行驶证的主页正面或一个行驶证副页正面。

# 调用URL

https://api.megvii.com/faceid/v5/ocr_vehicle_license

# 调用方法

POST

参数

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

# 返回值

字段	类型	说明
request_id	String	用于区分每一次请求的唯一的字符串。除非发生404（API_NOT_FOUND )或 403 （AUTHORIZATION_ERROR）错误，此字段必定返回。
content_main	Object	行驶证主页识别结构体，若side=main，则返回此字段；注意：此字段可能返回 null，表示取不到有效值。
content_second	Object	行驶证副页识别结构体，若side=second，则返回此字段；注意：此字段可能返回 null，表示取不到有效值。
error_message	String	错误信息。当请求失败时才会返回此字符串，具体返回内容见后续错误信息章节。否则此字段不存在。
time_used	Int	整个请求所花费的时间，单位为毫秒。除非发生404（API_NOT_FOUND )或 403 （AUTHORIZATION_ERROR）错误，此字段必定返回。

content字段结构：

主页/副页	字段	类型	说明
content_main	plate_no	String	号牌号码。
	vehicle_type	String	车辆类型。
	owner	String	所有人。
	address	String	住址。
	use_character	String	使用性质。
	model	String	品牌型号。
	vin	String	车辆识别代号。
	engine_no	String	发动机号码。
	register_date	Object	注册日期，一个Object对象，包含day（日）, month（月）, year （年）三个字段，都是Int类型值。
	issue_date	Object	发证日期，一个Object对象，包含day（日）, month（月）, year （年）三个字段，都是Int类型值。
	issued_by	String	签发机关。
content_second	plate_no	String	号牌号码。
	archive_code	String	档案编号。
	allow_num	String	核定载人数。
	total_mass	String	总质量。
	curb_weight	String	整备质量。
	load_quality	String	核定载质量。
	external_size	String	外廓尺寸。
	total_quasimass	String	准牵引总质量。
	marks	String	备注。
	record	String	检验记录。
	type	String	燃料类型。

注：不能确定字段内容时，结果会是null；

# 返回值示例

正确请求返回示例-主页

{
    "request_id": "1694686868,979016e0-3c7a-447e-a3eb-bf6a49d0ea46",
    "time_used": 1547,
    "content_main": {
        "plate_no": "京C12345",
        "vehicle_type": "小型轿车",
        "owner": "XXXXXX有限公司",
        "address": "北京市海淀区XXXX",
        "model": "丰田牌TVXXXXX",
        "use_character": "非营运",
        "engine_no": "76110577",
        "vin": "LBYXXXXX",
        "register_date": {
            "year": 2012,
            "month": 9,
            "day": 6
        },
        "issue_date": {
            "year": 2014,
            "month": 8,
            "day": 27
        },
        "issued_by": "广州省深圳市公安局交通警察支队"
    },
    "content_second": null
}

正确请求返回示例-副页

{
    "request_id": "1694686917,00475f20-ceb9-41dd-8dc1-8aa09b3ef412",
    "time_used": 609,
    "content_main": null,
    "content_second": {
        "plate_no": "京C12345",
        "archive_code": "",
        "allow_num": "5人",
        "total_mass": "1922kg",
        "curb_weight": "1470kg",
        "load_quality": "",
        "total_quasimass": "",
        "external_size": "4845X1830XXXXX",
        "marks": "",
        "record": "核验有效期至2024年04月新U",
        "type": "汽油/天然气"
    }
}

请求失败返回示例

{
   "error_message" : "INVALID_IMAGE_SIZE: image",
   "request_id" : "1461740007,71eeb124-08f0-47b3-8fc8-ac048cfa134d",
   "time_used" : 4
}

# 错误信息

HTTP 状态代码	错误信息	说明
400	IMAGE_ERROR_UNSUPPORTED_FORMAT	图像无法正确解析，有可能不是一个图像文件、或有数据破损。
400	INVALID_IMAGE_SIZE:<param>	客户上传的图像像素尺寸的长或宽超过4096像素。<param>对应图像太大的那个参数的名称请注意：如果图片存储尺寸大于2MB，会触发错误413(Request Entity Too Large)。
400	MISSING_ARGUMENTS: <key>	缺少某个必要参数。
403	AUTHORIZATION_ERROR	AppSecret和Appkey不匹配，或者该Appkey无权调用此API
403	CONCURRENCY_LIMIT_EXCEEDED	并发数超过限制
404	API_NOT_FOUND	所调用的API不存在
413	Request Entity Too Large	客户发送的请求大小超过了2MB限制。该错误的返回格式为纯文本，不是json格式。
500	INTERNAL_ERROR	服务器内部错误，当此类错误发生时请再次请求，如果一直出现此类错误，请及时联系客服。

# 调用示例

curl "https://api.megvii.com/faceid/v5/ocr_vehicle_license" -F api_key=<api_key>

-F api_secret=<api_secret>

-F image=@image_vehicle_license.jpg

# 历史版本文档

行驶证V2.0.0版本，仅支持行驶证主页正面识别，如有需要V2.0.0版本的文档，请从这里下载：ocr_vehicle_license V2.0.0（旧版本）文档。