车辆里程数据查询 API 接入教程:VIN 查询维保年检里程,识别二手车调表风险
二手车交易过程中,车辆行驶里程是评估车辆残值的核心指标。 - 低里程车辆:零部件磨损更小,剩余使用寿命更长,交易价格更高; - 高里程车辆:部件老化速度更快,后续维修成本更高,车辆折价更明显。 部分不良商家会进行**调表操作**,修改车辆仪表盘里程,人为压低表显里程抬高售价,给买家、汽车金融机构带来经济损失。 ## 一、接口基础信息 输入 VIN 车架号,可以查询车辆的综合精准里程情况及车辆信息,如里程情况、里程状态、存在调表风险等详细参数。 - 请求方式:GET / POST 请求参数 |参数|是否必填|说明| |:-:|:-:|:-:| |key|是|接口访问密钥| |vin|是|17 位车辆 VIN 车架号| |img_url|否|行驶证图片地址,可选参数| 返回示例 ``` { "code": 1, "msg": "操作成功", "data": { "vin": "WBA56666666661797", "brand_name": "宝马", "manufacturer_date": "2023", "last_driving_date": "2026-06-01", "display_mileage_by_actual": "58500", "driving_date_by_actual": "2026-06-01", "suspected_adjust": "0", "suspected_mileage_before_adjust": "", "suspected_before_adjust_month": "", "suspected_mileage_after_adjust": "", "suspected_after_adjust_month": "", "history_display_mileage_list": "[{\"displayMileage\":58500,\"hasErr\":false,\"month\":\"2026-06\",\"remark\":\"正常数据\"}]", "check_display_mileage_attention": "[\"车辆存在调表风险\"]" } } ``` ## 二、核心返回参数解读 1. **`display_mileage_by_actual`** 最近一条维保 / 年检档案登记的表显里程。**不等于车辆当前仪表盘里程**,属于历史业务存档快照。 2. **`suspected_adjust`** 系统自动检测里程是否倒退,判断是否疑似调表。`0=否`,`1=是`。 当该值为 0 时,4 个`suspected_xxx`调表相关字段为空,代表未检测到里程倒减记录。 >⚠️仅依靠此字段不足以完整评估风险,必须结合下面这条历史里程列表综合判断。 3. **`history_display_mileage_list`** 历史里程明细数组(JSON 字符串格式),是判断调表的核心原始数据,保存历次维保 / 年检里程与时间线。 - 正常车辆:时间越靠后,里程持续递增; - 疑似调表特征:后一次存档里程 < 前一次存档里程,里程反向下降。 >如果列表只有单条记录,缺少前后对比数据,无法验证里程变化趋势。 4. **`check_display_mileage_attention`** 风险备注数组,存放提示文案,可直接在前端展示。如示例中`["车辆存在调表风险"]`,含义是**历史记录不足,无法排除调表可能性**,不等于已经确认车辆调表。 ## 三、业务应用场景 1. **二手车交易** 核验车辆历史里程,筛查调表嫌疑车辆,辅助二手车估价;平台车源上架前置风控,减少交易纠纷。 2. **汽车金融贷前风控** 车贷、车辆抵押业务,核验客户申报里程真实性,防止虚报车况;评估抵押车辆残值,高风险车辆可下调估值或拒贷。 3. **保险定损** 承保前评估车辆损耗程度;车辆发生重大事故推定全损时,依托存档里程核算车辆剩余残值。 ## 四、Python如何接入 ```import requests import json key = "你的key" vin = "WBA5xxxxxxxxx21797" url = "https://www.tanshuapi.com/market/detail-163"#接口地址 params = { "key": key, "vin": vin } resp = requests.get(url, params=params) result = resp.json() print(json.dumps(result, ensure_ascii=False, indent=2)) ``` ## 五、开发注意事项 1. `history_display_mileage_list`、`check_display_mileage_attention`为 JSON 字符串,业务代码需要二次 JSON 解析; 2. 字段存在空字符串,转换数值前必须增加判空逻辑,避免程序异常; 3. 风控判断优先级:优先读取历史里程列表,不能仅依赖`suspected_adjust`标签; 4. 数据局限性:仅能识别**两次存档记录之间**发生的调表;如果调表发生在第一条存档记录之前,接口无法检出。