VIN解析API开发指南：从年检报告构建智能定损系统
在车辆管理和信息查询中，车架号（VIN码）查询是一个非常实用的功能。**万维易源提供的“车架号VIN查询车辆信息标准版”API为开发者和企业提供了高效、便捷的车辆信息查询服务，可以通过简单的接口调用获取车辆的详细信息。**本文将详细介绍如何使用该API，以及其核心功能和调用方法。
一、API概述
1. 接入点说明
- 数据精准：根据车架号（VIN码），查询车型对应的精准信息，包括品牌、发动机、上市时间、变速箱等数据。
- 扣费说明：该API只要查询了正确的VIN就要扣费。
- 更新频率：每年年初不定期更新一次前年新车数据。
2. 接口地址
https://route.showapi.com/1142-2?appKey={your_appKey}
请将 {your_appKey} 替换为你在万维易源平台申请的个人 appKey。
二、请求参数
以下是提交车架号查询任务所需的请求参数：
| 参数名称 | 类型 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|
| vin | String | lfv2a2150a3043256 | 是 | 车架号（VIN码）。 |
三、返回参数
以下是接口返回的参数及其描述：
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| ret_code | Number | 0 | 返回代码：0 表示查询要扣费-1 表示查询出错，不扣费 |
| remark | String | （错误信息） | 错误信息。 |
| data | Object[] | （车辆信息集合） | 查询结果集合。 |
| - assembly_factory | String | （制造厂） | 制造厂。 |
| - sale_name | String | 1.8THP 手自一体 380THP 尊贵型Nappa版 | 车款名称。 |
| - engine_type | String | 10UF51 6G01 | 发动机（电机）型号。 |
| - effluent_standard | String | 国5 | 排放标准。 |
| - model_name | String | C6 | 车型。 |
| - brand_name | String | 雪铁龙 | 品牌。 |
| - car_type | String | 轿车 | 车辆类型。 |
| - power | String | 150 | 功率。 |
| - year | String | 2015 | 年款。 |
| - made_month | String | 10 | 生产月份。 |
| - jet_type | String | （喷油类型） | 喷油类型。 |
| - transmission_type | String | 手自一体变速器(AMT) | 变速箱类型。 |
| - fuel_Type | String | 汽油 | 燃料类型。 |
| - cylinder_number | String | 4 | 发动机气缸数。 |
| - drive_style | String | 前轮驱动 | 驱动类型。 |
| - car_line | String | C6 | 车系。 |
| - fuel_num | String | 95# | 燃油标号。 |
| - guiding_price | String | 24.69 | 新车指导价。 |
| - made_year | String | 2015 | 生产年。 |
| - output_volume | String | 1.8 | 排量。 |
| - stop_year | String | --- | 停产年。 |
| - air_bag | String | （安全气囊） | 安全气囊。 |
| - cylinder_form | String | （气缸排列形式） | 气缸排列形式。 |
| - seat_num | String | 5 | 座位数。 |
| - vehicle_level | String | 中型车 | 车辆级别。 |
| - car_body | String | 三厢 | 轿车结构。 |
| - door_num | String | 四门 | 车门数。 |
| - manufacturer | String | 神龙汽车 | 制造商。 |
| - gears_num | String | 6 | 挡位数。 |
| - car_weight | String | （整备质量） | 整备质量。 |
| showapi_fee_code | Number | 0 | 费用代码。 |
四、调用示例
以下是一个使用 curl 命令调用该接口的示例：
curl \-X POST 'https://route.showapi.com/1142-2?appKey=your_appKey&vin=lfv2a2150a3043256' \-H 'Content-Type: application/x-www-form-urlencoded'
请将 your_appKey 替换为你在万维易源平台申请的 appKey。
五、返回示例
以下是接口返回的JSON示例：
{"showapi_res_error": "","showapi_res_code": 0,"showapi_res_id": "5f3a22a98d57ba59089aa207","showapi_res_body": {"ret_code": 0,"remark": "","data": [{"assembly_factory": "","sale_name": "1.8THP 手自一体 380THP 尊贵型Nappa版","engine_type": "10UF51 6G01","effluent_standard": "国5","model_name": "C6","brand_name": "雪铁龙","car_type": "轿车","power": "150","year": "2015","made_month": "10","jet_type": "","transmission_type": "手自一体变速器(AMT)","fuel_Type": "汽油","cylinder_number": "4","drive_style": "前轮驱动","car_line": "C6","fuel_num": "95#","guiding_price": "24.69","made_year": "2015","output_volume": "1.8","stop_year": "---","air_bag": "","cylinder_form": "","seat_num": "5","vehicle_level": "中型车","car_body": "三厢","door_num": "四门","manufacturer": "神龙汽车","gears_num": "6","car_weight": ""}],"showapi_fee_code": 0}
}
六、获取 appKey
要获取 appKey，请访问万维易源的控制台页面：
查看 appKey
七、总结
万维易源的“车架号VIN查询车辆信息标准版”API为开发者和企业提供了一个高效、便捷的工具，可以通过简单的接口调用获取车辆的详细信息。通过该API，可以快速查询车辆的品牌、发动机、上市时间、变速箱等信息，适用于车辆管理、二手车交易、保险理赔等多种场景。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。