车架号 VIN 查询 API 接口如何对接？

车架号 VIN 查询 API 接口是一种基于互联网的软件接口，用户可以通过该接口向服务器发送包含车架号的请求，服务器接收到请求后，会根据车架号在数据库中进行查询，并将查询到的车辆信息以特定的格式返回给用户。

车架号（Vehicle Identification Number，VIN）是车辆的唯一身份标识，包含了车辆的品牌、型号、生产年份、车身类型、发动机配置、排量、变速箱类型等重要信息。车架号VIN查询API接口通过输入这17位编码，能够快速获取车辆的详细信息，在现代汽车行业中发挥着至关重要的作用。

那么接下来我们来聊一聊怎么对接车架号 VIN 查询 API 接口。

首先我们找到一家有车架号 VIN 查询 API 接口的服务商，如数勋API,注册账号，购买免费套餐：

然后让我们技术把车架号 VIN 查询 API 接口对接到系统中，数勋API支持多种编程语言对接，下面以java为例：

package com.shuxun.data.impl.demo;

import com.shuxun.common.core.util.HttpUtil;
import org.apache.commons.codec.digest.DigestUtils;

import java.util.HashMap;
import java.util.Map;

public class VinQueryDemo {

    private static final String APP_KEY = "您的appKey";
    private static final String APP_SECRET = "您的appSecret";
    private static final String API_URL = "https://api.shuxuntech.com/v1/vin/query";
    public static void main(String[] args) {
        String timestamp = System.currentTimeMillis()+"";
        String sign = DigestUtils.sha256Hex(APP_KEY + timestamp + APP_SECRET);

        Map<String, String> header = new HashMap<>(4);
        header.put("appKey", APP_KEY);
        header.put("timestamp", timestamp);
        header.put("sign", sign);

        Map<String, String> params = new HashMap<>(2);
        params.put("vin", "");

        // 工具类下载地址 https://file.shuxuntech.com/other/code/util.zip
        String result = HttpUtil.get(API_URL, header, params);
        System.out.println("返回结果="+result);
    }
}

对接好后传入身份证照片,身份证正面或者反面base64,不超过1mb,识别照片文字信息并返回,返回示例如下：

正面返回：

{
    "code": "0",
    "msg": "成功",
    "isFee": 1,
    "seqNo": "bc393r21lk7mz2i6rmgt5oyp33tbcks7",
    "data": {
        "result": 1,
        "info": {
            "gearboxinfo": { //变速箱信息
                "gearboxbrand": "捷特科", //变速箱品牌
                "joint": null, //接口型号
                "gravityoil": "4L-5L", //重力加油量
                "gearboxmodel": "RE0F10D/JF017E/JATCO", //变速箱型号
                "mechanicaloil": "12L" //机械加油量
            },
            "logo": "https://img.shuxuntech.com/vin_logo/202402/1708504285067.png", //车辆图片
            "fueltype": "汽油", //燃油类型
            "frontbraketype": "通风盘式", //前制动类型
            "comfuelconsumption": "8.4", //油耗
            "enginemodel": "QR25", //发动机型号（参考）
            "gearnum": "7", //档位数
            "machineoil": { //机油信息
                "volume": "4.6L", //参考用量
                "viscosity": "0W-20", //粘稠度
                "level": "SP", //质量等级
                "grade": "全合成" //机油分类
            },
            "len": "4897", //长 mm
            "maxhorsepower": "186", //最大马力(Ps)
            "price": "27.13万", //厂商指导价
            "parkingbraketype": "脚刹", //驻车制动类型
            "vin": "LGBR4DE43LR380247", //车架号
            "displacement": "2.5L", //排量(L)
            "brand": "日产", //品牌
            "environmentalstandards": "国六", //排放标准
            "rearbraketype": "通风盘式", //后制动类型
            "height": "1691", //高 mm
            "drivemode": "前置前驱", //驱动方式
            "ratedloadweight": null, //额定载质量
            "displacementml": "2488", //排量(mL)
            "iscorrect": 1, //1 VIN符合规则 0 VIN不符合规则
            "groupid": "3887", //车型组ID
            "weight": "1700", //重量，kg
            "chassis": null, //底盘
            "version": "智联豪华", //版本
            "groupname": "楼兰 2.5L(2015.08-)", //车型组名称
            "yeartype": "2021", //年款
            "sizetype": "中型SUV", //尺寸类型
            "seatnum": "5", //座位数
            "doornum": "5", //车门数
            "wheelbase": "2830", //轴距
            "name": "日产 楼兰 2021款 2.5L 两驱 智联豪华版", //名称
            "geartype": "无级变速(CVT)", //变速箱类型
            "cylindernum": "4", //气缸数(个)
            "bodystructure": "承载式", //车体结构
            "fuelgrade": "92号", //燃油标号
            "carid": 132868, //车ID 对应车型API中的ID
            "manufacturer": "东风日产", //厂家名称
            "fuelmethod": "多点电喷", //供油方式
            "engine": "QR25", //发动机
            "bodytype": "SUV", //车身型式
            "gearbox": "CVT无级变速(模拟7挡)", //变速箱
            "fronttiresize": "235/65 R18", //前轮胎尺寸
            "maxpower": "124", //最大功率 KW
            "isimport": 0, //是否是进口 0国产 1进口
            "reartiresize": "235/65 R18", //后轮胎尺寸
            "listdate": "2020-08-13", //上市日期
            "width": "1908", //宽 mm
            "carlist": [ //车型列表 可能的车型
                {
                    "name": "日产 楼兰 2021款 2.5L 两驱 智联豪华版",//名称
                    "typeid": 1985, //类型ID
                    "model": "DFL6490VANR4", //工信部型号
                    "typename": "楼兰", //类型名称
                    "carid": 132868 //车ID 对应车型API中的ID,
                    "manufacturer": "长沙中联重工科技发展股份有限公司", //厂家名称
                    "enginemodel": "YCA07260N-60;YCA07245N-60;YCA07220N-60;YCA07190N-60",//发动机型号（参考）
                    "doornum": "", //车门数
                    "len": "9220", //长 mm
                    "price": "79.5万", //厂商指导价
                    "geartype": "手动档", //变速箱类型
                    "width": "2500", //宽
                    "height": "3070" //高
                }
            ],
            "typename": "楼兰", //车型名称 对应typeid
            "marketprice": "22.13万" //市场价
        }
    }
}

错误返回：

返回字段描述：

data对象说明：

code错误码说明：