您手头有一个VIN，并且需要将其转换为您本周可以在应用程序中使用的结构化车辆数据。在本指南结束时，您将能够通过curl和Node.js向Zyla API Hub上的VIN解码API发出经过身份验证的请求，检索解码的车辆规格，并可选择通过VIN获取玻璃零件候选。
VIN解码API的功能
VIN解码API返回与VIN相关的车辆的结构化信息，包括制造商、型号、型号年份、车身样式、驱动系统、发动机规格等。典型的用例包括：
- 服务接收和零件查找
- 车队资产验证和记录丰富
- 电子商务适配和兼容性检查
还有一个玻璃端点，可以通过VIN和零件类型检索详细的玻璃信息，包括OEM和售后零件编号、规格、特性和适配候选。
您可以在Zyla API Hub上查看列表：VIN解码API。Zyla是一个拥有超过10,000个公共API的市场，涵盖金融、数据丰富、人工智能、地理定位、电子商务和公用事业等类别。一个账户，一个密钥，一个订阅模型，适用于您订阅的每个API。
在Zyla API Hub上开始
要调用API，您需要从Zyla API Hub获取API密钥：
- 打开VIN解码API页面。
- 点击“订阅”或“开始免费试用”（如果可用）。市场使用订阅加配额模型（而不是按调用付费）。对于此API，您可以期待7天的试用或50个请求；请查看API页面以获取当前访问选项和定价。
- 从您的仪表板复制您的API密钥。
所有请求都通过HTTP头Authorization: Bearer YOUR_API_KEY进行身份验证。您可以在zylalabs.com浏览其他API，并在此处创建帐户：注册。
您可以调用的端点
1) 解码
方法： GET
URL： https://zylalabs.com/api/6580/vin-decode-api/14977/decode
描述： 传递您想要检查的VIN号并接收其信息。
参数： 此端点没有记录请求参数。使用Authorization头通过您的API密钥进行身份验证。
官方curl示例（按原样复制/粘贴）：
curl -s -X GET "https://zylalabs.com/api/6580/vin-decode-api/14977/decode"
-H "Authorization: Bearer YOUR_API_KEY"官方JSON示例响应：
{
"VIN": "JTEBU14RX30013995",
"Manufacturer": "Toyota Motor Corp",
"Adress line 1": "1 Toyota-cho Toyota -Shi",
"Adress line 2": "471-8571 Aichi-Ken",
"Region": "Asia",
"Country": "Japan",
"Note": "Manufacturer builds more than 500 vehicles per year",
"Entered VIN": "JTEBU14RX30013995",
"Corrected VIN": "JTEBU14RX30013995",
"Squish VIN": "JTEBU14R30",
"WMI": "JTE",
"VIS identifier": "N/A",
"VDS": "BU14RX30",
"Year identifier": "3",
"Serial number": "013995",
"VIN type": "normal",
"Check digit": "valid",
"Make": "Toyota",
"Model": "4Runner",
"Model year": "2003",
"Body style": "4 Doors SUV",
"Engine type": "V6",
"Fuel type": "Gasoline",
"Transmission": "Automatic",
"Manufactured in": "Japan",
"Body type": "SUV",
"Number of doors": "4",
"Number of seats": "5",
"Displacement SI": "3998",
"Displacement CID": "244",
"Displacement Nominal": "4.0",
"Engine head": "DOHC",
"Engine valves": "24",
"Engine cylinders": "6",
"Engine aspiration": "Naturally",
"Compression ratio": "10.0",
"Engine HorsePower": "245",
"Engine KiloWatts": "183",
"Automatic gearbox": "4AT",
"MPG city": "15-17",
"MPG highway": "19-21",
"Driveline": "4WD",
"Anti-Brake System": "4-Wheel ABS",
"Front brake type": "Disc",
"Rear brake type": "Drum",
"Front suspension": "Independent",
"Rear suspension": "Live",
"Front spring type": "Coil",
"Rear spring type": "Coil",
"Tire front": "265/70R16",
"Tire rear": "265/70R16",
"GVWR range": "5001-6000"
}您通常会从此有效负载中读取的内容：
- 制造商、型号、型号年份、车身样式、车身类型
- 发动机类型、气缸、排量、马力、燃料类型
- 变速器、驱动系统、刹车和悬挂细节
- 校验位和WMI/VDS段用于验证逻辑
2) 玻璃
方法： GET
URL： https://zylalabs.com/api/6580/vin-decode-api/26921/glass
描述： 通过VIN检索详细的车辆玻璃信息，包括OEM和售后零件编号、规格、特性以及每个玻璃组件的适配。
参数：
- vin（字符串，必需）：JTEBU14RX30013995
- parts（字符串，必需）：挡风玻璃
官方curl示例（按原样复制/粘贴）：
官方JSON示例响应：
您通常会从此有效负载中读取的内容：
- 特定玻璃组件的OEM和售后零件编号
- 决定适配和订购的特性和材料规格
- 免责声明，指示候选在订购前应进行验证
您的第一个Node.js调用
以下是一个使用原生fetch（Node 18+）的最小Node.js示例。它展示了如何调用解码端点，检查HTTP错误，并从JSON响应中读取常用字段。此端点没有记录请求参数——需要身份验证头。
import fetch from "node-fetch";
const API_KEY = "YOUR_API_KEY";
async function decodeVin() {
const url = "https://zylalabs.com/api/6580/vin-decode-api/14977/decode";
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
// 在生产中考虑短时间超时/重试；为了清晰起见，这里保持最小。
});
if (!res.ok) {
const text = await res.text();
throw new Error(`VIN Decode API error: ${res.status} ${res.statusText} - ${text}`);
}
const data = await res.json();
// 提取您的应用程序可能需要的字段。
const summary = {
vin: data["VIN"],
make: data["Make"],
model: data["Model"],
year: data["Model year"],
bodyType: data["Body type"],
engine: {
type: data["Engine type"],
cylinders: data["Engine cylinders"],
horsepower: data["Engine HorsePower"],
displacementSi: data["Displacement SI"]
},
transmission: data["Transmission"],
driveline: data["Driveline"]
};
console.log("Decoded summary:", summary);
}
decodeVin().catch(err => {
console.error(err);
process.exit(1);
});Node.js调用玻璃
此示例使用记录的查询参数vin和parts。它打印请求的玻璃组件的OEM和售后零件编号。
import fetch from "node-fetch";
const API_KEY = "YOUR_API_KEY";
async function getGlassCandidates() {
const url = "https://zylalabs.com/api/6580/vin-decode-api/26921/glass?vin=JTEBU14RX30013995&parts=windshield";
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
}
});
if (!res.ok) {
const text = await res.text();
throw new Error(`Glass API error: ${res.status} ${res.statusText} - ${text}`);
}
const data = await res.json();
const components = data.glass?.windshield || [];
for (const c of components) {
console.log({
oem: c.oem_part_number,
aftermarket: c.aftermarket_part_number,
type: c.glass_type,
features: c.features
});
}
}
getGlassCandidates().catch(err => {
console.error(err);
process.exit(1);
});节省时间的实用细节
- 身份验证：始终发送Authorization: Bearer YOUR_API_KEY。不要将密钥放在查询参数中。
- 缓存：VIN是特定车辆配置的静态标识符。缓存按VIN键入的解码结果，以减少调用并提高重复查找的延迟。
- 错误处理：记录非2xx响应和响应主体以帮助调试。将敏感密钥排除在日志之外。
- 速率和配额：Zyla API使用带配额的订阅（而不是按调用付费）。对于此API，首次访问通常包括7天的试用或50个请求。请查看列表以获取当前详细信息。
- 数据使用：使用玻璃候选数据时，请注意响应中的免责声明，并在订购前根据OEM/售后目录验证零件编号。
现实世界的集成模式
- 服务调度：在签到时扫描或输入VIN，调用解码以获取型号年份、发动机类型和驱动系统，然后自动填充维修订单的正确规格表。
- 零件电子商务：使用解码预先筛选兼容零件。对于玻璃产品，使用vin和parts调用玻璃端点，以在PDP上显示候选零件编号和规格。
- 车队丰富：从远程信息处理或标题中摄取VIN，并填充排量、马力和GVWR范围等属性，以改善路由和维护计划。
通过MCP从AI代理调用API
Zyla API Hub上的每个API也可以通过AI代理（Claude Code、Cursor、Windsurf和任何与MCP兼容的客户端）通过MCP端点调用。将您的客户端指向：
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
请在此处参考MCP文档：MCP。配置完成后，您的代理可以使用您的Zyla API密钥调用相同的VIN解码API工具——每个服务无需额外的身份验证。
您现在可以运行的完整curl
如果您只需要验证连接性和身份验证，请运行官方解码示例（首先替换YOUR_API_KEY）：
然后尝试使用vin和parts查询参数调用玻璃端点：
在哪里找到文档并管理您的密钥
- API列表：VIN解码API
- 市场主页：zylalabs.com
如果您在多个产品之间集成，统一的Zyla密钥和订阅简化了身份验证和计费。您可以在扩展覆盖范围时直接从市场发现其他汽车和数据丰富API。
常见问题
是否有免费计划？
没有免费计划。市场使用带配额的订阅。对于此API，您可以期待7天的试用或50个请求以开始。请查看API页面以获取当前访问选项和定价。
我如何进行身份验证？
在每个请求中发送头Authorization: Bearer YOUR_API_KEY到上述端点。
解码端点接受什么参数？
解码端点没有记录请求参数。使用Authorization头，如官方示例所示，并读取返回的JSON以获取VIN详细信息。
我如何请求特定组件的玻璃数据？
使用vin和parts查询参数调用玻璃端点。示例：parts=windshield。响应包括OEM和售后候选零件编号和规格。在订购前验证候选零件。
我可以从AI代理调用这个吗？
可以。在任何与MCP兼容的客户端中使用Zyla MCP端点https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY。有关设置，请参见MCP文档。
准备好构建了吗？创建您的帐户，获取API密钥，并在今天发货您的第一个集成：注册。然后打开VIN解码API页面并从市场中订阅。
