驾驶证OCR识别V2

提交查询

1、接口描述

提交查询

2、请求地址

https://api.ihuyi.com/ocr/dlv2/Submit.json

3、请求头说明

参数名称	参数值描述	示例	类型	必填
Content-Type	内容类型，固定值	application/x-www-form-urlencoded	string	是

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【认证核验】-【OCR识别】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【OCR识别】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
img_file	图片文件(img_file、img_url二选一传递，小于1MB，支持jpg、png、bmp)		file	否
img_url	图片url(img_file、img_url二选一传递，小于1MB，支持jpg、png、bmp)		string	否
cardSide	FRONT 为驾驶证主页正面（有红色印章的一面）， BACK 为驾驶证副页正面（有档案编号的一面）。默认值为：FRONT	FRONT	string	否
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int	是
msg	提交结果描述	提交成功\|提交失败	string	是
idcardid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string
result	识别结果		object
info	数据		object
FrontInfo	正页识别信息		object
CardCode	证号	150***********3218	string
Name	姓名	刘**	string
Sex	性别	男	string
Nationality	国籍	中国/CHN	string
Address	住址	内蒙古自治区市县**	string
DateOfBirth	出生日期（YYYY-MM-DD）	19**-10-08	string
DateOfFirstIssue	初次领证日期（YYYY-MM-DD）	19**-09-03	string
Class	准驾车型	A2	string
StartDate	有效期开始时间（YYYY-MM-DD）	20**-09-03	string
EndDate	有效期截止时间（新版驾驶证返回 YYYY-MM-DD，新版驾驶证返回有效期限 X年）	长期	string
IssuingAuthority	发证单位	内蒙古自治区**市公安局交通管理支队	string
State	状态（仅电子驾驶证支持返回该字段）		string
CumulativeScore	累积记分（仅电子驾驶证支持返回该字段）		string
BackInfo	副页识别信息		object
ArchivesCode	档案编号		string
CardCode	证号		string
Record	记录		string
Name	姓名		string

6、响应状态码说明

code	msg
0	未知错误
1	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	应用不存在
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
40505	没有签定合同
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
4086	通道无效
4010	通道错误
4201	查询失败
4202	图片识别失败
4203	参数错误
4204	系统异常
4301	img_file、img_url不能同时为空
4302	上传图片大小必须控制在5KB-1MB之间
4303	上传图片格式不正确，只支持bmp,jpg,jpeg,png
4304	上传图片失败

7、GET传参示例

https://api.ihuyi.com/ocr/dlv2/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&img_file=&img_url=&cardSide=FRONT&time=1623643787

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>提交成功</msg><idcardid>16236437872836</idcardid><result><info><FrontInfo><CardCode>150***********3218</CardCode><Name>刘**</Name><Sex>男</Sex><Nationality>中国/CHN</Nationality><Address>内蒙古自治区**市**县**</Address><DateOfBirth>19**-10-08</DateOfBirth><DateOfFirstIssue>19**-09-03</DateOfFirstIssue><Class>A2</Class><StartDate>20**-09-03</StartDate><EndDate>长期</EndDate><IssuingAuthority>内蒙古自治区**市公安局交通管理支队</IssuingAuthority><State></State><CumulativeScore></CumulativeScore></FrontInfo><BackInfo><ArchivesCode></ArchivesCode><CardCode></CardCode><Record></Record><Name></Name></BackInfo></info></result></SubmitResult>

{    "code":
            2
        ,        "msg":
            "提交成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "info":
                {    "FrontInfo":
        {    "CardCode":
        "150***********3218"
    ,        "Name":
        "刘**"
    ,        "Sex":
        "男"
    ,        "Nationality":
        "中国/CHN"
    ,        "Address":
        "内蒙古自治区**市**县**"
    ,        "DateOfBirth":
        "19**-10-08"
    ,        "DateOfFirstIssue":
        "19**-09-03"
    ,        "Class":
        "A2"
    ,        "StartDate":
        "20**-09-03"
    ,        "EndDate":
        "长期"
    ,        "IssuingAuthority":
        "内蒙古自治区**市公安局交通管理支队"
    ,        "State":
        ""
    ,        "CumulativeScore":
        ""
        }
        ,        "BackInfo":
        {    "ArchivesCode":
        ""
    ,        "CardCode":
        ""
    ,        "Record":
        ""
    ,        "Name":
        ""
        }
            }
                }
                }

示例（失败）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>提交失败</msg></SubmitResult>

{"code":1,"msg":"提交失败"}

9、PHP生成动态密码方式代码示例

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'dlv2'; //固定值
$time = '1623643787';
$password=md5($account.$password.$app.$time);
$password=md5('xxxxxxxxxxxxxxxxxdlv21623643787');

//注意：所有字符编码统一为UTF-8

驾驶证OCR识别V2

提交查询

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

9、PHP生成动态密码方式代码示例

10、代码示例

免费体验

填写验证码后，点击“开通体验账户”自动开通体验账户。