VIN解码器Lite的API

您需要在本周解码一个VIN，并将输出无缝集成到您的工作流程中。通过本指南的结束，您将能够调用一个真实的VIN解码器Lite端点，解析制造商/型号/年份及其他基本信息，并可选择性地提取完整的车辆详细信息或玻璃零件信息——使用来自Zyla API Hub的一个API密钥。

您可以用VIN解码器Lite构建什么

欧洲VIN解码器API从VIN返回核心车辆身份字段，其“Lite”端点专注于基本信息：国家、制造商、型号、类别、地区、WMI/VDS/VIS和型号年份。这对于入职流程、零件/目录预选择、接收表单和快速资格检查来说已经足够。当您需要更多时，同一个API还提供完整的VIN解码器端点和用于OEM/售后市场挡风玻璃参考的玻璃端点。

本文展示了真实的端点、确切的URL、所需的参数以及您今天可以直接使用的可复制请求。

在Zyla API Hub上开始

打开API列表，订阅并获取您的API密钥。身份验证通过HTTP头Authorization: Bearer YOUR_API_KEY进行。计费为订阅+配额（不是按调用计费）。这里的第一个API提供7天的试用；请查看列表以获取当前访问选项。

在欧洲VIN解码器API上开始7天试用

您可以调用的端点

1) VIN解码器（完整详细信息）

方法：GET
URL： https://zylalabs.com/api/888/europe-vin-decoder-api/684/vin-decoder
所需参数：vin
目的：解码欧洲制造的VIN，并接收制造商、型号、年份、修饰、车身样式、车辆类别、类型、制造商、制造地点和其他属性。

示例请求（官方示例）：

curl -s -X GET "https://zylalabs.com/api/888/europe-vin-decoder-api/684/vin-decoder?vin=WVWZZZ3BZWE689725" \
-H "Authorization: Bearer YOUR_API_KEY"

示例响应（官方示例）：

{
"Make": "大众",
"Model": "帕萨特",
"Model year": "1998",
"Trim level": "第四代",
"Body style": "5门旅行车|掀背车",
"Vehicle class": "中型车",
"Vehicle type": "乘用车",
"Manufactured in": "德国",
"Manufacturer": "大众汽车股份公司",
"Adress line 1": "沃尔夫斯堡/汉诺威",
"Adress line 2": "沃尔夫斯堡/汉诺威",
"Region": "欧洲",
"Country": "德国",
"Note": "制造商每年生产超过500辆汽车",
"Body type": "旅行车|掀背车",
"Number of doors": "5",
"Number of seats": "5",
"Driveline": "2WD",
"VIN": "WVWZZZ3BZWE689725"
}

您通常会从此有效负载中读取的内容：

制造商、型号、年份：用户界面身份字段，用于表单、目录和报告。
修饰级别、车身样式、车身类型：对零件兼容性和用户界面过滤器有用。
车辆类别、车辆类型：车队细分和分析。
制造地点、制造商、国家、地区：合规检查和路由。
门/座位数量、驱动方式：容量和驱动逻辑。

2) VIN解码器Lite（快速基本信息）

方法：GET
URL： https://zylalabs.com/api/888/europe-vin-decoder-api/7243/vin-decoder-lite
所需参数：vin
目的：检索适合轻量级验证和预填充的压缩车辆身份属性。
备注：描述提供了一个示例VIN，如1C4NJPBB3FD398798；您通过vin查询参数传递您的VIN。

示例请求：

示例响应：

首先提取的内容：

国家、地区：本地化和监管处理。
制造商、型号、年份：用户界面标签和零件预选择。
wmi、vds、vis：当您需要时的低级VIN分段。
类别：资格检查和定价层级。

3) 玻璃（VIN到挡风玻璃零件数据）

方法：GET
URL： https://zylalabs.com/api/888/europe-vin-decoder-api/26811/glass
所需参数：vin，parts
目的：通过VIN检索详细的车辆玻璃信息，包括OEM和售后市场零件编号、规格、特性和玻璃组件的适配性。

示例请求：

示例响应：

当您的流程需要在扫描或输入VIN后立即获取零件候选时使用此功能——包括可交叉参考的售后市场编号。免责声明指出您应在购买前验证零件候选与目录的匹配。

最小集成：使用Python调用VIN解码器Lite

下面的代码片段调用VIN解码器Lite端点，处理HTTP错误，并打印您可能会映射到模型中的关键身份字段。

import os
import sys
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
VIN = "WVWZZZ3BZWE689725"

url = "https://zylalabs.com/api/888/europe-vin-decoder-api/7243/vin-decoder-lite"
params = {"vin": VIN}
headers = {"Authorization": f"Bearer {API_KEY}"}

try:
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
except requests.exceptions.HTTPError as e:
print(f"HTTP error: {e} - response: {getattr(e.response, 'text', '')}", file=sys.stderr)
sys.exit(1)
except requests.exceptions.RequestException as e:
print(f"请求失败: {e}", file=sys.stderr)
sys.exit(1)

data = resp.json()

# 映射下游系统中常用的字段
print("VIN:", data.get("vin"))
print("制造商:", data.get("manufacturer"))
print("型号:", data.get("model"))
print("年份:", data.get("year"))
print("国家:", data.get("country"))
print("地区:", data.get("region"))
print("类别:", data.get("class"))
print("WMI/VDS/VIS:", data.get("wmi"), data.get("vds"), data.get("vis"))

提示：

按VIN缓存。对于大多数工作流程，VIN解码的身份数据是稳定的——按VIN缓存响应可以减少重复查找。
在需要的地方规范化大小写（例如，制造商名称）以保持显示一致性。
如果您需要更丰富的属性，请切换到完整的VIN解码器端点，使用相同的vin参数和Authorization头。

您现在可以运行的快速curl

复制、粘贴并将YOUR_API_KEY替换为您的密钥。这是官方示例，返回制造商/型号/年份及更多信息，适用于欧洲VIN：

常见集成模式

表单预填充：用户输入VIN；您调用VIN解码器Lite以预填充制造商、型号和年份。验证三字符WMI以进行区域检查。
零件查找预选择：先解码VIN，然后调用玻璃端点，使用parts=windshield显示兼容候选项，然后进行目录导航。
车队摄取作业：批量解码VIN的CSV，按VIN缓存，并存储标准化的“制造商/型号/年份/车身”以进行分析。
风险/资格门：使用类别、车身样式（来自完整解码器）和地区将用户路由到正确的计划或工作流程。

节省时间的字段处理说明

所有此处显示的端点均要求vin参数。对于玻璃，parts也是必需的（例如，windshield）。
每个请求的身份验证通过头Authorization: Bearer YOUR_API_KEY进行。
响应形状因端点而异；读取您需要的特定字段，并使用.get()或等效方法进行保护。
由于VIN解码的属性是稳定的，短期缓存（例如，按VIN缓存数小时或数天）可以减少重复调用而不冒过时的风险。

通过MCP从AI代理调用API

如果您希望从MCP兼容客户端（Claude Code、Cursor、Windsurf等）协调调用，请将您的工具指向Zyla MCP端点，并在MCP URL中将您的API密钥作为查询参数包含。然后，您的代理可以使用相同的vin和parts参数，以及此处描述的Authorization头调用上述相同的端点。请参见MCP入口点：

MCP

请保持本文中列出的端点URL完全不变，以便代理的HTTP工具调用。