切换主题
VIN款型查询(高精准)-GetModelByVIN
适用场景
- 车辆档案补全:通过 VIN 匹配品牌、车系、车型和配置,减少人工录入。
- 二手车估值与收车初筛:确认精确款型后,辅助匹配指导价、车况和历史交易数据。
- 金融与保险核验:为车贷、保险报价和风险规则提供标准化车型基础信息。
- 维修与配件适配:根据精确车型确认保养、维修和配件适用范围。
- 数据治理与人工复核:发现登记资料与 VIN 解析结果不一致时,触发复核。
接口地址
详见合作邮件通知
接口描述
| 请求协议 | 请求方式 | 编码格式 | 返回格式 |
|---|---|---|---|
| HTTPS | GET/POST | UTF-8 | JSON |
接口参数
| 参数名字 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | 字符串 | 必须 | 访问令牌,生成令牌可使用App.Auth.ApplyToken接口 |
| vin | 字符串 | 必须 | 最小:17;最大:17,车架号,例如:1HGBH41JXMN000001 |
响应字段
返回结果
| 返回结果 | 类型 | 说明 |
|---|---|---|
| ret | 整型 | 状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误 |
| data | 对象或混合类型 | 业务数据,由各自接口指定,通常为对象 |
| msg | 字符串 | 提示信息,失败时的错误提示 |
Data数组字段含义
| 字段 | 数据类型 | 字段含义 | 举例 |
|---|---|---|---|
| vin | varchar | 请求入参的车架号 | |
| autoID | int | AUTODATA公司车型库款型ID;空白的标记为0 | 26847 |
| bodyStruct | varchar | 车身结构 | SUV |
| chexi | varchar | 车系 | 自由侠(第一代,2016-) |
| chexing | varchar | 车型款型 | 自由侠 2016款 1.4T 手动动能版 |
| clxh | varchar | 车辆型号 | GFA7140DFCA |
| code | varchar | 款型编码。 | 8LR3UFIUC25V7O86 S200089M31708581 |
| code5 | varchar | code5编码与chexi之间是一对一关系 | 8LR3UF |
| csys | varchar | 车身颜色 | 皓白色 |
| edzk | varchar | 额定载客 | 5 |
| fdjhm | varchar | 发动机号码 | 200991 |
| fdjMod | varchar | 发动机 | 1.4T 150马力 L4 |
| fdjxh | varchar | 发动机型号 | 523A0027 |
| gl | varchar | 功率 | 110 |
| hlj | varchar | 后轮距 | 1540 |
| jiage | decimal | 指导价 | 13.48 |
| jibie | varchar | 车型级别 | 小型SUV |
| ltgg | varchar | 轮胎规格 | 215/65R16 98H |
| lts | varchar | 轮胎数 | 4 |
| niank | int | 年款 | 2016 |
| oilWay | varchar | 燃料类型 | 汽油 |
| pfbz | varchar | 排放标准 | GB18352.5-2013国V |
| qlj | varchar | 前轮距 | 1540 |
| qud | varchar | 驱动类型 | 前置前驱 |
| riqi | varchar | 出厂日期 | 2016/12/27 |
| wkc | varchar | 外廓长 | 4245 |
| wkg | varchar | 外廓高 | 1695 |
| wkk | varchar | 外廓宽 | 1805 |
| yh | varchar | 油耗 | 6.8 |
| zbzl | varchar | 整备质量 | 1385 |
| zh | varchar | 轴荷 | 934/881 |
| zj | varchar | 轴距 | 2570 |
| zs | varchar | 轴数 | 2 |
| zzl | varchar | 总质量 | 1815 |
| zzs | varchar | 制造商 | 广汽菲克Jeep |
示例
返回json案例
如果是vin对应的是多个可能的款型,则list中包含多个数组。
text
{
"ret": 200.0,
"data": {
"vin": "LB37742Z6JB134**0",//生产场景下是完整显示 VIN
"list": [
{
"autoID": 33668.0,
"bodyStruct": "SUV",
"chexi": "博越(第一代,2016-)",
"chexing": "博越 2018款 1.8TD 自动两驱智联型4G互联版",
"clxh": "HQ6453C03",
"code": "8IN2U6LUD29V7C56",
"code5": "8IN2U6",
"csys": "吉利白",
"edzk": "5",
"fdjhm": "JACB0209402",
"fdjMod": "1.8T 184马力 L4",
"fdjxh": "JLE-4G18TDB",
"gl": "135",
"hlj": "1550",
"jiage": 12.98,
"jibie": "紧凑型SUV",
"ltgg": "225/60R18",
"lts": "4",
"niank": 2018.0,
"oilWay": "汽油",
"pfbz": "GB18352.5-2013国Ⅴ",
"qlj": "1560",
"qud": "前置前驱",
"riqi": "2018-10-29",
"wkc": "4519",
"wkg": "1694",
"wkk": "1831",
"yh": "7.8",
"zbzl": "1690",
"zh": "1110/955",
"zj": "2670",
"zs": "2",
"zzl": "2065",
"zzs": "吉利汽车"
}
]
},
"msg": ""
}错误码
错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400,客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406,access_token令牌校验不通过 |
| 407 | ret=407,app_key权限不足,或未知应用 |
| 408 | ret=408,当前用户禁止使用,或用户未登录 |
| 500 | 表示服务端内部错误 |