全国车辆VIN基础信息查验

提交查询

1、接口描述

提交查询

2、请求地址

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

3、请求头说明

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

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【认证核验】-【车辆与道路运输信息验证】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【车辆与道路运输信息验证】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
vin	VIN车架号（17位字母数字组合）	LEUFHUEFUEF678789	string	是
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int	是
msg	提交结果描述	提交成功\|提交失败	string	是
idcardid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string
result	认证结果		object
info	车辆基础信息		object
vin	VIN车架号	LEUFHUEFUEF678789	string
vehicle	车辆名称	半挂牵引车	string
brand	品牌名称	阿克托斯牌	string
type	车辆型号代码	Actros 2644	string
engineType	发动机型号	LKWJFW323	string
fuel	燃料种类	柴油	string
cc	排量（单位:ml）	11946	string
power	功率	320	string
frontTread	前轮距		string
rearTread	后轮距		string
tyre	轮胎数		string
Specifications	轮胎规格		string
wheelBase	轴距		string
shaft	轴数		string
long	长（单位:mm）	6865	string
wide	宽（单位:mm）	2500	string
high	高（单位:mm）	3483	string
inside_long	货厢内部长(货车)（单位:mm）		string
inside_wide	货厢内部宽(货车)（单位:mm）		string
inside_high	货厢内部高(货车)（单位:mm）		string
crossWeight	总质量		string
curbWeight	整备质量	8550	string
passengers	核定载客数(货车此字段为空)		string
pps	出厂年份	2013	string
loadWeight	核定载质量		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 不符
406	VIN车架号不能为空
4086	通道无效
4010	通道错误
4201	vin错误
4202	查询无结果

7、GET传参示例

https://api.ihuyi.com/veh/natvinbase/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&vin=LEUFHUEFUEF678789&time=1623643787

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>提交成功</msg><idcardid>16236437872836</idcardid><result><info><vin>LEUFHUEFUEF678789</vin><vehicle>半挂牵引车</vehicle><brand>阿克托斯牌</brand><type>Actros 2644</type><engineType>LKWJFW323</engineType><fuel>柴油</fuel><cc>11946</cc><power>320</power><frontTread></frontTread><rearTread></rearTread><tyre></tyre><Specifications></Specifications><wheelBase></wheelBase><shaft></shaft><long>6865</long><wide>2500</wide><high>3483</high><inside_long></inside_long><inside_wide></inside_wide><inside_high></inside_high><crossWeight></crossWeight><curbWeight>8550</curbWeight><passengers></passengers><pps>2013</pps><loadWeight></loadWeight></info></result></SubmitResult>

{    "code":
            2
        ,        "msg":
            "提交成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "info":
                {    "vin":
            "LEUFHUEFUEF678789"
        ,        "vehicle":
            "半挂牵引车"
        ,        "brand":
            "阿克托斯牌"
        ,        "type":
            "Actros 2644"
        ,        "engineType":
            "LKWJFW323"
        ,        "fuel":
            "柴油"
        ,        "cc":
            "11946"
        ,        "power":
            "320"
        ,        "frontTread":
            ""
        ,        "rearTread":
            ""
        ,        "tyre":
            ""
        ,        "Specifications":
            ""
        ,        "wheelBase":
            ""
        ,        "shaft":
            ""
        ,        "long":
            "6865"
        ,        "wide":
            "2500"
        ,        "high":
            "3483"
        ,        "inside_long":
            ""
        ,        "inside_wide":
            ""
        ,        "inside_high":
            ""
        ,        "crossWeight":
            ""
        ,        "curbWeight":
            "8550"
        ,        "passengers":
            ""
        ,        "pps":
            "2013"
        ,        "loadWeight":
            ""
            }
                }
                }

示例（失败）

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

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

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

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

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

全国车辆VIN基础信息查验

提交查询

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

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

10、代码示例

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