机动车行驶证OCR识别

目录

前言

接口文档

1. 描述

2. 图片要求

3. 调用URL

4. 调用方法

5. 请求体格式

6. 请求参数

7. 返回值说明

8. cards数组中单个元素的结构

9. 返回值示例

10. 当前API特有错误ERROR_MESSAGE

11. 通用的ERROR_MESSAGE

---

前言

目前第三方各大API市场均有提供检测和识别机动车驾驶证信息OCR数据接口，聚合数据0.08元/次，阿里云0.083元/次。博主提供的数据接口调用价格0.02元/次，量大更优惠，识别准确率高达99.9%。为防止恶意调用，如需使用，请添加博主QQ(943402659)，博主需后台开通调用权限。

 

接口文档

1. 描述

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

• 行驶证图像须为正拍（垂直角度拍摄），但是允许有一定程度的旋转角度；
• 仅支持图像里有一个行驶证的主页正面，如果同时出现多页、或正副页同时出现，可能会返回空结果。

2. 图片要求

图片格式：JPG(JPEG)，PNG
图片像素尺寸：最小48*48像素，最大4096*4096像素
图片文件大小：2MB

3. 调用URL

www.biyeyuan.org.cn:8099/api/certificate/v1/getOcrVehicleLicense

4. 调用方法

POST

5. 请求体格式

multipart/form-data

6. 请求参数

参数名称	是否必选	类型	参数说明
api_key	必选	String	调用此API的API Key
image_url	必选（三选一）	String	图片的URL 注：在下载图片时可能由于网络等原因导致下载图片时间过长，建议使用image_file参数直接上传图片。
image_file		File	一个图片，二进制文件，需要用post multipart/form-data的方式上传。
image_base64		String	base64编码的二进制图片数据 如果同时传入了image_url、image_file和image_base64参数，本API使用顺序为image_file优先，image_url最低。

7. 返回值说明

字段	类型	说明
request_id	String	用于区分每一次请求的唯一的字符串。
cards	Array	检测出证件的数组 注：如果没有检测出证件则为空数组
image_id	String	被检测的图片在系统中的标识
time_used	Int	整个请求所花费的时间，单位为毫秒
error_message	String	当请求失败时才会返回此字符串，具体返回内容见后续错误信息章节。否则此字段不存在。

8. cards数组中单个元素的结构

字段	类型	说明
type	Int	证件版本。 返回 3，表示是行驶证。
plate_no	String	号牌号码。
vehicle_type	String	车辆类型。
owner	String	所有人。
address	String	住址。
use_character	String	使用性质。
model	String	品牌型号。
vin	String	车辆识别代号。
engine_no	String	发动机号码。
register_date	String	注册日期，格式为YYYY-MM-DD
issue_date	String	发证日期，格式为YYYY-MM-DD
side	String	表示行驶证的正面或者反面。该字段目前只会返回“front”，表示是正面
issued_by	String	签发机关。

9. 返回值示例

{
    "cards": [
        {
            "issue_date": "2010-04-02", 
            "vehicle_type": "小型轿车", 
            "issued_by": "江商省上饶市公安局交通警察支队", 
            "vin": "LFVXXXXXXXXX536", 
            "plate_no": "皖EHXXXX", 
            "side": "front", 
            "use_character": "非营运", 
            "address": "江西省上饶县XXXXXXXXXXX", 
            "owner": "邹XX", 
            "model": "路虎AUD", 
            "register_date": "2010-04-02", 
            "type": 3, 
            "engine_no": "ANXXXXX43"
        }
    ], 
    "time_used": 3474, 
    "request_id": "1473763408,e2c2a352-a6bd-4620-9f74-c96841aed500"
}

10. 当前API特有错误ERROR_MESSAGE

错误码	说明
400	参数<param>对应的图像无法正确解析，有可能不是一个图像文件、或有数据破损。
400	客户上传的图像太大。具体是指图像像素尺寸的长或宽超过4096像素。<param>对应图像太大的那个参数的名称
400	无法从指定的image_url下载图片，图片URL错误或者无效
412	下载图片超时

11. 通用的ERROR_MESSAGE

错误码	说明
403	api_key非法
403	api_key被停用、调用次数超限、没有调用此API的权限，或者没有以当前方式调用此API的权限。 目前的<reason>有： Denied. （没有权限调用当前API）
403	并发数超过限制。 注：这里的并发控制数超出限制，是指该API Key的QPS已经达到上限。如需要提高API Key的QPS配额请查看价格方案或者联系我们。
400	缺少某个必选参数。
400	某个参数解析出错（比如必须是数字，但是输入的是非数字字符串; 或者长度过长，etc.）
400	同时传入了要求是二选一或多选一的参数。如有特殊说明则不返回此错误。
413	客户发送的请求大小超过了2MB限制。该错误的返回格式为纯文本，不是json格式。
404	所调用的API不存在。
500	服务器内部错误，当此类错误发生时请再次请求，如果持续出现此类错误，请及时联系技术支持团队。