短信签名快速报备,马上注册寻求客户经理支持!
所有文档
车辆出行
文档中心 > 车辆出行 > VIN查询车辆信息

VIN查询车辆信息


提交查询

1、接口描述

提交查询

2、请求地址

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

3、请求头说明

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

4、请求参数说明

参数名称 参数值描述 示例 类型 必填
account APIID(用户中心【认证核验】-【车辆与道路运输信息验证】-【产品总览】查看) xxxxxxxx string
password 1、APIKEY(用户中心【认证核验】-【车辆与道路运输信息验证】-【产品总览】查看)
2、动态密码(生成动态密码方式请看该文档末尾的说明)
xxxxxxxxx string
vin 车架号 4567890 string
engine_number VIN 码对应的发动机号码 12345678 string
notice_model 公告号(厂商生产车辆时向工信部申请的号码) 202012345 string
time Unix时间戳(10位整型数字,当使用动态密码方式时为必填) 1623643787 string

5、响应参数

参数名称 参数值描述 示例 类型 必返
code 返回值为2时,表示提交成功 2|1 int
msg 提交结果描述 提交成功|提交失败 string
idcardid 当提交成功后,此字段为流水号,否则为0或空 16236437872836|0 string
result 认证结果 object
lists[] 数据列表 array
color 颜色 string
brand_id 品牌(厂商)ID 73 int
series_id 车系ID 36391 int
model_id 车型ID 1847118 int
brand_name 厂商(品牌)名称 凯迪拉克 string
series_name 车系名称 凯迪拉克CT5 string
model_name 车型名称 2023款 凯迪拉克CT5 28T 豪华型(标准版) string
vehicle_type 车辆种类(1:乘用车 2:商用车 3:摩托车) 1 int
model_year 车型年款 2023 int
model_price 车型指导价(单位:万元) 29.47 float
model_liter 排量 2.0T string
model_gear 变速箱类型 自动 string
model_emission_standard 排放标准 国6 string
min_reg_year 最小上牌年份 2022 int
max_reg_year 最大上牌年份 2025 int
make_date 出厂日期 2023-05-24 string
series_group_name 车系组名 上汽通用凯迪拉克 string
seat_number 座位数 5 string
response 返回详情 string
maker_c 厂商(仅乘用车返回) 上汽通用凯迪拉克 string
body_dim_c 长*宽*高(mm)(仅乘用车返回) 4924*1883*1453 string
seat_count_c 座位数(个)(仅乘用车返回) 5 string
car_weight_c 整备质量(kg)(仅乘用车返回) 1640 string
total_mass_c 总质量(kg)(仅乘用车返回) 2055 string
car_payload_c 最大载重质量(kg)(仅乘用车返回) string
fuel_type_c 燃料形式(仅乘用车返回) 汽油 string
car_width_c 宽度(mm)(仅乘用车返回) 1883 string
car_length_c 长度(mm)(仅乘用车返回) 4924 string
car_height_c 高度(mm)(仅乘用车返回) 1453 string
engine_type_c 发动机型号(仅乘用车返回) LSY string
cargo_dim_c 货箱尺寸(mm)(仅乘用车返回) string
engine_number 发动机号 LSY*231381026* string
notice_code 公告号 SGM7201ABB2 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 查询无结果
4202 查询失败

7、GET传参示例

https://api.ihuyi.com/veh/vinveh/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&vin=4567890&engine_number=12345678&notice_model=202012345&time=1623643787

8、响应示例

示例(成功)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>提交成功</msg><idcardid>16236437872836</idcardid><result><lists><list><color></color><brand_id>73</brand_id><series_id>36391</series_id><model_id>1847118</model_id><brand_name>凯迪拉克</brand_name><series_name>凯迪拉克CT5</series_name><model_name>2023款 凯迪拉克CT5 28T 豪华型(标准版)</model_name><vehicle_type>1</vehicle_type><model_year>2023</model_year><model_price>29.47</model_price><model_liter>2.0T</model_liter><model_gear>自动</model_gear><model_emission_standard>国6</model_emission_standard><min_reg_year>2022</min_reg_year><max_reg_year>2025</max_reg_year><make_date>2023-05-24</make_date><series_group_name>上汽通用凯迪拉克</series_group_name><seat_number>5</seat_number><response></response><maker_c>上汽通用凯迪拉克</maker_c><body_dim_c>4924*1883*1453</body_dim_c><seat_count_c>5</seat_count_c><car_weight_c>1640</car_weight_c><total_mass_c>2055</total_mass_c><car_payload_c></car_payload_c><fuel_type_c>汽油</fuel_type_c><car_width_c>1883</car_width_c><car_length_c>4924</car_length_c><car_height_c>1453</car_height_c><engine_type_c>LSY</engine_type_c><cargo_dim_c></cargo_dim_c><engine_number>LSY*231381026*</engine_number><notice_code>SGM7201ABB2</notice_code></list><list><color></color><brand_id>73</brand_id><series_id>36391</series_id><model_id>1847118</model_id><brand_name>凯迪拉克</brand_name><series_name>凯迪拉克CT5</series_name><model_name>2023款 凯迪拉克CT5 28T 豪华型(标准版)</model_name><vehicle_type>1</vehicle_type><model_year>2023</model_year><model_price>29.47</model_price><model_liter>2.0T</model_liter><model_gear>自动</model_gear><model_emission_standard>国6</model_emission_standard><min_reg_year>2022</min_reg_year><max_reg_year>2025</max_reg_year><make_date>2023-05-24</make_date><series_group_name>上汽通用凯迪拉克</series_group_name><seat_number>5</seat_number><response></response><maker_c>上汽通用凯迪拉克</maker_c><body_dim_c>4924*1883*1453</body_dim_c><seat_count_c>5</seat_count_c><car_weight_c>1640</car_weight_c><total_mass_c>2055</total_mass_c><car_payload_c></car_payload_c><fuel_type_c>汽油</fuel_type_c><car_width_c>1883</car_width_c><car_length_c>4924</car_length_c><car_height_c>1453</car_height_c><engine_type_c>LSY</engine_type_c><cargo_dim_c></cargo_dim_c><engine_number>LSY*231381026*</engine_number><notice_code>SGM7201ABB2</notice_code></list><list><color></color><brand_id>73</brand_id><series_id>36391</series_id><model_id>1847118</model_id><brand_name>凯迪拉克</brand_name><series_name>凯迪拉克CT5</series_name><model_name>2023款 凯迪拉克CT5 28T 豪华型(标准版)</model_name><vehicle_type>1</vehicle_type><model_year>2023</model_year><model_price>29.47</model_price><model_liter>2.0T</model_liter><model_gear>自动</model_gear><model_emission_standard>国6</model_emission_standard><min_reg_year>2022</min_reg_year><max_reg_year>2025</max_reg_year><make_date>2023-05-24</make_date><series_group_name>上汽通用凯迪拉克</series_group_name><seat_number>5</seat_number><response></response><maker_c>上汽通用凯迪拉克</maker_c><body_dim_c>4924*1883*1453</body_dim_c><seat_count_c>5</seat_count_c><car_weight_c>1640</car_weight_c><total_mass_c>2055</total_mass_c><car_payload_c></car_payload_c><fuel_type_c>汽油</fuel_type_c><car_width_c>1883</car_width_c><car_length_c>4924</car_length_c><car_height_c>1453</car_height_c><engine_type_c>LSY</engine_type_c><cargo_dim_c></cargo_dim_c><engine_number>LSY*231381026*</engine_number><notice_code>SGM7201ABB2</notice_code></list></lists></result></SubmitResult>
{    "code":
            2
        ,        "msg":
            "提交成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "lists":
                    [    {    "color":
            ""
        ,        "brand_id":
            "73"
        ,        "series_id":
            "36391"
        ,        "model_id":
            "1847118"
        ,        "brand_name":
            "凯迪拉克"
        ,        "series_name":
            "凯迪拉克CT5"
        ,        "model_name":
            "2023款 凯迪拉克CT5 28T 豪华型(标准版)"
        ,        "vehicle_type":
            "1"
        ,        "model_year":
            "2023"
        ,        "model_price":
            "29.47"
        ,        "model_liter":
            "2.0T"
        ,        "model_gear":
            "自动"
        ,        "model_emission_standard":
            "国6"
        ,        "min_reg_year":
            "2022"
        ,        "max_reg_year":
            "2025"
        ,        "make_date":
            "2023-05-24"
        ,        "series_group_name":
            "上汽通用凯迪拉克"
        ,        "seat_number":
            "5"
        ,        "response":
            ""
        ,        "maker_c":
            "上汽通用凯迪拉克"
        ,        "body_dim_c":
            "4924*1883*1453"
        ,        "seat_count_c":
            "5"
        ,        "car_weight_c":
            "1640"
        ,        "total_mass_c":
            "2055"
        ,        "car_payload_c":
            ""
        ,        "fuel_type_c":
            "汽油"
        ,        "car_width_c":
            "1883"
        ,        "car_length_c":
            "4924"
        ,        "car_height_c":
            "1453"
        ,        "engine_type_c":
            "LSY"
        ,        "cargo_dim_c":
            ""
        ,        "engine_number":
            "LSY*231381026*"
        ,        "notice_code":
            "SGM7201ABB2"
                }
    ,        {    "color":
            ""
        ,        "brand_id":
            "73"
        ,        "series_id":
            "36391"
        ,        "model_id":
            "1847118"
        ,        "brand_name":
            "凯迪拉克"
        ,        "series_name":
            "凯迪拉克CT5"
        ,        "model_name":
            "2023款 凯迪拉克CT5 28T 豪华型(标准版)"
        ,        "vehicle_type":
            "1"
        ,        "model_year":
            "2023"
        ,        "model_price":
            "29.47"
        ,        "model_liter":
            "2.0T"
        ,        "model_gear":
            "自动"
        ,        "model_emission_standard":
            "国6"
        ,        "min_reg_year":
            "2022"
        ,        "max_reg_year":
            "2025"
        ,        "make_date":
            "2023-05-24"
        ,        "series_group_name":
            "上汽通用凯迪拉克"
        ,        "seat_number":
            "5"
        ,        "response":
            ""
        ,        "maker_c":
            "上汽通用凯迪拉克"
        ,        "body_dim_c":
            "4924*1883*1453"
        ,        "seat_count_c":
            "5"
        ,        "car_weight_c":
            "1640"
        ,        "total_mass_c":
            "2055"
        ,        "car_payload_c":
            ""
        ,        "fuel_type_c":
            "汽油"
        ,        "car_width_c":
            "1883"
        ,        "car_length_c":
            "4924"
        ,        "car_height_c":
            "1453"
        ,        "engine_type_c":
            "LSY"
        ,        "cargo_dim_c":
            ""
        ,        "engine_number":
            "LSY*231381026*"
        ,        "notice_code":
            "SGM7201ABB2"
                }
    ,        {    "color":
            ""
        ,        "brand_id":
            "73"
        ,        "series_id":
            "36391"
        ,        "model_id":
            "1847118"
        ,        "brand_name":
            "凯迪拉克"
        ,        "series_name":
            "凯迪拉克CT5"
        ,        "model_name":
            "2023款 凯迪拉克CT5 28T 豪华型(标准版)"
        ,        "vehicle_type":
            "1"
        ,        "model_year":
            "2023"
        ,        "model_price":
            "29.47"
        ,        "model_liter":
            "2.0T"
        ,        "model_gear":
            "自动"
        ,        "model_emission_standard":
            "国6"
        ,        "min_reg_year":
            "2022"
        ,        "max_reg_year":
            "2025"
        ,        "make_date":
            "2023-05-24"
        ,        "series_group_name":
            "上汽通用凯迪拉克"
        ,        "seat_number":
            "5"
        ,        "response":
            ""
        ,        "maker_c":
            "上汽通用凯迪拉克"
        ,        "body_dim_c":
            "4924*1883*1453"
        ,        "seat_count_c":
            "5"
        ,        "car_weight_c":
            "1640"
        ,        "total_mass_c":
            "2055"
        ,        "car_payload_c":
            ""
        ,        "fuel_type_c":
            "汽油"
        ,        "car_width_c":
            "1883"
        ,        "car_length_c":
            "4924"
        ,        "car_height_c":
            "1453"
        ,        "engine_type_c":
            "LSY"
        ,        "cargo_dim_c":
            ""
        ,        "engine_number":
            "LSY*231381026*"
        ,        "notice_code":
            "SGM7201ABB2"
                }
        ]
            }
                }

示例(失败)

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

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

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

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

10、代码示例

在线咨询
服务热线:
4008 808 898

免费体验

提交成功
若短信发送异常,系统将自动给您发送语音验证码,请注意接听电话。

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

收不到短信验证码?
×