道路运输从业人员资格证核验

提交查询

1、接口描述

提交查询

2、请求地址

https://api.ihuyi.com/veh/transqual/Submit.json

3、请求头说明

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

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【认证核验】-【车辆与道路运输信息验证】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【车辆与道路运输信息验证】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
name	姓名	张三	string	是
id_card_no	身份证号	310000190001301001	string	是
province_code	省行政区划代码	110000	string	否
reg_no	从业资格证号	12345678	string	否
date	证件有效期（YYYYMMDD）	20200101	string	否
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int	是
msg	提交结果描述	提交成功\|提交失败	string	是
idcardid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string
result	认证结果		object
certificateState	证照状态（0-无效；1-有效）	1	string
licenseIssueOrgan	发证机关	佳木斯市交通运输局	string
maturityWarning	到期预警（0-有效期超过半月；1-有效期不足半月）	0	string
verifiedValidityDate	有效期核验（0-不一致；1-一致）	1	string
workTypeCode	从业资格证类型	A1	string
certificateCodeIsEquals	从业资格证号是否一致（0-不一致；1-一致）	1	string
certificateCode	从业资格证号	1234567890	string

6、响应状态码说明

code	msg
0	未知错误
1	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	应用不存在
404	姓名不能为空
4041	姓名格式不正确（2-10个中文汉字）
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
40505	没有签定合同
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
4086	通道无效
4010	通道错误
4201	查询无结果
4202	系统异常

7、GET传参示例

https://api.ihuyi.com/veh/transqual/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&name=张三&id_card_no=310000190001301001&province_code=110000&reg_no=12345678&date=20200101&time=1623643787

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>提交成功</msg><idcardid>16236437872836</idcardid><result><certificateState>1</certificateState><licenseIssueOrgan>佳木斯市交通运输局</licenseIssueOrgan><maturityWarning>0</maturityWarning><verifiedValidityDate>1</verifiedValidityDate><workTypeCode>A1</workTypeCode><certificateCodeIsEquals>1</certificateCodeIsEquals><certificateCode>1234567890</certificateCode></result></SubmitResult>

{    "code":
            2
        ,        "msg":
            "提交成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "certificateState":
                "1"
                    ,        "licenseIssueOrgan":
                "佳木斯市交通运输局"
                    ,        "maturityWarning":
                "0"
                    ,        "verifiedValidityDate":
                "1"
                    ,        "workTypeCode":
                "A1"
                    ,        "certificateCodeIsEquals":
                "1"
                    ,        "certificateCode":
                "1234567890"
                        }
                }

示例（失败）

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

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

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

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'transqual'; //固定值
$name = '张三';
$id_card_no = '310000190001301001';
$time = '1623643787';
$password=md5($account.$password.$app.$name.$id_card_no.$time);
$password=md5('xxxxxxxxxxxxxxxxxtransqual张三3100001900013010011623643787');

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

道路运输从业人员资格证核验

提交查询

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

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

10、代码示例

5分钟快速自助开通免费体验账户