Você tem um VIN em mãos e precisa transformá-lo em dados de veículo estruturados que você pode usar em seu aplicativo esta semana. Ao final deste guia, você fará solicitações autenticadas à API de Decodificação de VIN no Zyla API Hub a partir do curl e Node.js, recuperará especificações de veículo decodificadas e, opcionalmente, buscará candidatos a peças de vidro pelo VIN.
O que a API de Decodificação de VIN faz
A API de Decodificação de VIN retorna informações estruturadas para um veículo associado a um VIN, incluindo marca, modelo, ano do modelo, estilo da carroceria, sistema de transmissão, especificações do motor e mais. Casos de uso típicos incluem:
- Recepção de serviço e consulta de peças
- Verificação de ativos de frota e enriquecimento de registros
- Verificações de compatibilidade e ajuste para e‑commerce
Há também um endpoint de vidro que recupera informações detalhadas sobre vidro por VIN e tipo de peça, incluindo números de peças OEM e de reposição, especificações, características e candidatos a ajuste.
Você pode explorar a listagem no Zyla API Hub aqui: API de Decodificação de VIN. Zyla é um marketplace com mais de 10.000 APIs públicas em categorias como finanças, enriquecimento de dados, IA, geolocalização, e‑commerce e utilitários. Uma conta, uma chave, um modelo de assinatura para cada API à qual você se inscrever.
Começando no Zyla API Hub
Para chamar a API, você precisará de uma chave de API do Zyla API Hub:
- Abra a página da API de Decodificação de VIN.
- Clique em Assinar ou Iniciar Teste Gratuito quando disponível. O marketplace utiliza um modelo de assinatura mais cota (não pago por chamada). Para esta API, você pode esperar um teste de 7 dias ou 50 solicitações para começar; verifique a página da API para opções de acesso e preços atuais.
- Copie sua chave de API do seu painel.
Todas as solicitações são autenticadas com o cabeçalho HTTP Authorization: Bearer YOUR_API_KEY. Você pode navegar por APIs adicionais em zylalabs.com e criar uma conta aqui: Registrar.
Endpoints que você pode chamar
1) Decodificar
Método: GET
URL: https://zylalabs.com/api/6580/vin-decode-api/14977/decode
Descrição: Passe o número VIN que você deseja verificar e receba suas informações.
Parâmetros: Nenhum parâmetro de solicitação está documentado para este endpoint. Autentique-se com sua chave de API usando o cabeçalho Authorization.
Exemplo oficial de curl (copie/cole como está):
curl -s -X GET "https://zylalabs.com/api/6580/vin-decode-api/14977/decode" \
-H "Authorization: Bearer YOUR_API_KEY"Exemplo de resposta JSON oficial:
{
"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"
}O que você geralmente lerá a partir deste payload:
- Marca, Modelo, Ano do modelo, Estilo da carroceria, Tipo de carroceria
- Tipo de motor, cilindros, deslocamento, potência, tipo de combustível
- Transmissão, sistema de transmissão, detalhes de freio e suspensão
- Dígito de verificação e segmentos WMI/VDS para lógica de validação
2) Vidro
Método: GET
URL: https://zylalabs.com/api/6580/vin-decode-api/26921/glass
Descrição: Recupere informações detalhadas sobre vidro de veículo por VIN, incluindo números de peças OEM e de reposição, especificações, características e ajuste para cada componente de vidro.
Parâmetros:
- vin (string, obrigatório): JTEBU14RX30013995
- parts (string, obrigatório): para-brisa
Exemplo oficial de curl (copie/cole como está):
Exemplo de resposta JSON oficial:
O que você geralmente lerá a partir deste payload:
- Números de peças OEM e de reposição para componentes de vidro específicos
- Características e especificações de material para decidir ajuste e pedido
- Isenção indicando que os candidatos devem ser verificados antes do pedido
Sua primeira chamada Node.js
Abaixo está um exemplo mínimo de Node.js usando fetch nativo (Node 18+). Ele mostra como chamar o endpoint Decode, verificar um erro HTTP e ler campos comumente usados da resposta JSON. Nenhum parâmetro de solicitação está documentado para este endpoint—o cabeçalho de autenticação é necessário.
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}`
},
// Considere timeouts/retries curtos em produção; mantenha mínimo aqui para clareza.
});
if (!res.ok) {
const text = await res.text();
throw new Error(`Erro na API de Decodificação de VIN: ${res.status} ${res.statusText} - ${text}`);
}
const data = await res.json();
// Extraia campos que seu aplicativo provavelmente precisa.
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("Resumo decodificado:", summary);
}
decodeVin().catch(err => {
console.error(err);
process.exit(1);
});Chamada Node.js para Vidro
Este exemplo usa os parâmetros de consulta documentados vin e parts. Ele imprime números de peças OEM e de reposição para o componente de vidro solicitado.
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(`Erro na API de Vidro: ${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);
});Detalhes práticos que economizam tempo
- Autenticação: Sempre envie Authorization: Bearer YOUR_API_KEY. Não coloque a chave em um parâmetro de consulta.
- Cache: VINs são identificadores estáticos para uma configuração de veículo específica. Armazene em cache os resultados decodificados indexados por VIN para reduzir chamadas e melhorar a latência em buscas repetidas.
- Tratamento de erros: Registre respostas não-2xx e o corpo da resposta para ajudar na depuração. Mantenha chaves sensíveis fora dos logs.
- Taxa e cota: As APIs Zyla usam assinatura com cotas (não pago por chamada). Para esta API, o primeiro acesso geralmente inclui um teste de 7 dias ou 50 solicitações. Verifique a listagem para detalhes atuais.
- Uso de dados: Ao usar dados de candidatos a vidro, observe a isenção na resposta e verifique os números das peças contra catálogos OEM/de reposição antes de fazer o pedido.
Padrões de integração do mundo real
- Agendamento de serviços: Digitalize ou insira um VIN no check-in, chame Decode para obter o ano do modelo, tipo de motor e sistema de transmissão, e depois preencha automaticamente a ordem de reparo com a ficha técnica correta.
- e‑commerce de peças: Use Decode para pré-filtrar peças compatíveis. Para produtos de vidro, chame o endpoint Glass com vin e parts para exibir números de peças e especificações candidatas nos PDPs.
- Enriquecimento de frota: Ingestão de VINs de telemetria ou títulos e preenchimento de atributos como deslocamento, potência e faixa de GVWR para melhorar o planejamento de roteamento e manutenção.
Chame a API de agentes de IA via MCP
Cada API no Zyla API Hub também pode ser chamada de agentes de IA (Claude Code, Cursor, Windsurf e qualquer cliente compatível com MCP) via o endpoint MCP. Aponte seu cliente para:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Consulte a documentação do MCP aqui: MCP. Uma vez configurado, seu agente pode invocar as mesmas ferramentas da API de Decodificação de VIN usando sua chave de API Zyla—sem dança extra de autenticação por serviço.
Curl completo que você pode executar agora
Se você só precisa verificar conectividade e autenticação, execute o exemplo oficial de Decode (substitua YOUR_API_KEY primeiro):
Então tente o endpoint Glass com parâmetros de consulta vin e parts:
Onde encontrar documentação e gerenciar sua chave
- Listagem de API: API de Decodificação de VIN
- Home do marketplace: zylalabs.com
Se você está integrando vários produtos, a chave unificada Zyla e a assinatura simplificam autenticação e faturamento. Você pode descobrir outras APIs de automotivo e enriquecimento de dados diretamente do marketplace à medida que expande a cobertura.
FAQ
Há um plano gratuito?
Não há plano gratuito. O marketplace utiliza assinatura com cotas. Para esta API, você pode esperar um teste de 7 dias ou 50 solicitações para começar. Verifique a página da API para opções de acesso e preços atuais.
Como faço para autenticar?
Envie o cabeçalho Authorization: Bearer YOUR_API_KEY com cada solicitação para os endpoints mostrados acima.
Quais parâmetros o endpoint Decode aceita?
Nenhum parâmetro de solicitação está documentado para o endpoint Decode. Use o cabeçalho Authorization como mostrado no exemplo oficial e leia o JSON retornado para detalhes do VIN.
Como solicito dados de vidro para um componente específico?
Chame o endpoint Glass com parâmetros de consulta vin e parts. Exemplo: parts=windshield. A resposta inclui números de peças candidatas OEM e de reposição e especificações. Verifique os candidatos contra catálogos antes de fazer o pedido.
Posso chamar isso de um agente de IA?
Sim. Use o endpoint MCP da Zyla em https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY em qualquer cliente compatível com MCP. Consulte a documentação do MCP para configuração.
Pronto para construir? Crie sua conta, obtenha uma chave de API e envie sua primeira integração hoje: Registrar. Então abra a página da API de Decodificação de VIN e assine de dentro do marketplace.
