如何通过 VIN 用 3 行代码查询车辆召回

Source: Dev.to

快速概览

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.vehicle-finder.com/v1/recalls?vin=1HGCM82633A004352"

你会收到结构化的 JSON，包含该 VIN 的所有召回信息——召回编号、描述、补救措施、完成状态。

为什么不直接使用 NHTSA？

你可以，但：

• NHTSA 的 API 默认返回 XML，JSON 格式不统一
• 没有身份验证 = 没有速率限制 = 可靠性差
• 数据分散在多个端点，模式各不相同
• 无法一次性获取召回 + 技术服务公告（TSB） + 投诉信息

Vehicle Finder API 将所有这些统一为一致的 REST API，提供标准的 JSON 响应、API‑key 认证和速率限制。

完整示例（Python）

import requests

API_KEY = "vda_your_key_here"
BASE = "https://api.vehicle-finder.com/v1"

# Decode a VIN
vin = "1HGCM82633A004352"
vehicle = requests.get(f"{BASE}/vehicles/vin/{vin}",
    headers={"X-API-Key": API_KEY}).json()

print(f"Vehicle: {vehicle['data']['year']} {vehicle['data']['make']} {vehicle['data']['model']}")

# Get recalls
recalls = requests.get(f"{BASE}/recalls?vin={vin}",
    headers={"X-API-Key": API_KEY}).json()

for recall in recalls["data"]:
    print(f"Recall: {recall['component']}: {recall['summary']}")

还能查询哪些信息？

除了召回，API 还涵盖：

• 换油规格 – 类型、容量、滤清器部件号
• 保养计划 – 制造商推荐的间隔
• 诊断码 – OBD‑II 故障码描述及常见修复方法
• TSB – 制造商发布的技术服务公告
• 消费者投诉 – 来自 NHTSA 的碰撞/火灾/受伤报告
• 扭矩规格、牵引能力、液体规格 等更多内容

入门指南

1. 在 vehicle-finder.com 注册（免费，500 次请求/月份）
2. 确认你的电子邮件
3. 在仪表盘中创建 API 密钥
4. 开始发送请求

完整文档：api.vehicle-finder.com/docs

我之所以构建这个服务，是因为我的项目需要它，并且觉得其他开发者也可能会用到。免费层真的很实用——每月 500 次请求足以支撑一个侧项目或原型。欢迎提供反馈！