API para decodificador de VIN lite

Você precisa decodificar um VIN esta semana e integrar a saída ao seu fluxo de trabalho sem surpresas. Ao final deste guia, você será capaz de chamar um endpoint real do Decodificador de VIN Lite, analisar marca/modelo/ano e outros essenciais, e opcionalmente puxar detalhes completos do veículo ou informações de peças de vidro—usando uma chave de API do Zyla API Hub.

O que você pode construir com um decodificador de VIN lite

A API do Decodificador de VIN da Europa retorna campos de identidade do veículo a partir de um VIN, e seu endpoint “Lite” foca nos essenciais: país, fabricante, modelo, classe, região, WMI/VDS/VIS e ano do modelo. Isso é suficiente para fluxos de integração, pré-seleção de peças/catálogo, formulários de entrada e verificações rápidas de elegibilidade. Quando você precisa de mais, a mesma API também oferece um endpoint completo do Decodificador de VIN e um endpoint de Vidro para referências de para-brisas OEM/mercado de reposição.

Ilustração: API para decodificador de VIN lite

Este artigo demonstra os endpoints reais, URLs exatas, parâmetros necessários e solicitações copiáveis que você pode enviar hoje.

Começando no Zyla API Hub

Abra a lista de APIs, inscreva-se e pegue sua chave de API. A autenticação é via cabeçalho HTTP Authorization: Bearer YOUR_API_KEY. A cobrança é por assinatura + cota (não pago por chamada). A primeira API aqui oferece um teste de 7 dias; verifique a lista para opções de acesso atuais.

Comece o teste de 7 dias na API do Decodificador de VIN da Europa

Endpoints que você pode chamar

1) Decodificador de VIN (detalhes completos)

Método: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/684/vin-decoder
Parâmetros obrigatórios: vin
Propósito: Decodificar um VIN fabricado na Europa e receber marca, modelo, ano, acabamento, estilo da carroceria, classe do veículo, tipo, fabricante, local de fabricação e outros atributos.

Exemplo de solicitação (exemplo oficial):

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

Exemplo de resposta (exemplo oficial):

{
"Make": "Volkswagen",
"Model": "Passat",
"Model year": "1998",
"Trim level": "Geração IV",
"Body style": "5 Portas Perua|hatchback",
"Vehicle class": "Carro de médio porte",
"Vehicle type": "Carro de passageiro",
"Manufactured in": "Alemanha",
"Manufacturer": "Volkswagen AG",
"Adress line 1": "Wolfsburg/Hannover",
"Adress line 2": "Wolfsburg/Hannover",
"Region": "Europa",
"Country": "Alemanha",
"Note": "O fabricante constrói mais de 500 veículos por ano",
"Body type": "Perua|hatchback",
"Number of doors": "5",
"Number of seats": "5",
"Driveline": "2WD",
"VIN": "WVWZZZ3BZWE689725"
}

O que você normalmente lerá deste payload:

Marca, Modelo, Ano do modelo: campos de identidade voltados para o usuário para formulários, catálogos e relatórios.
Nível de acabamento, Estilo da carroceria, Tipo de carroceria: úteis para compatibilidade de peças e filtros de UI.
Classe do veículo, Tipo de veículo: segmentação de frota e análises.
Fabricado em, Fabricante, País, Região: verificações de conformidade e roteamento.
Número de portas/assentos, Transmissão: capacidade e lógica de transmissão.

2) Decodificador de VIN Lite (essenciais rápidos)

Método: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/7243/vin-decoder-lite
Parâmetros obrigatórios: vin
Propósito: Recuperar atributos de identidade do veículo condensados adequados para validações leves e preenchimento automático.
Notas: A descrição fornece um exemplo de VIN como 1C4NJPBB3FD398798; você passa seu VIN através do parâmetro de consulta vin.

Exemplo de solicitação:

Exemplo de resposta:

O que extrair primeiro:

país, região: manuseio de localização e regulatório.
fabricante, modelo, ano: rótulos de UI e pré-seleção de peças.
wmi, vds, vis: segmentação de VIN de baixo nível quando você precisar.
classe: verificações de elegibilidade e faixas de preços.

3) Vidro (dados de peças de para-brisa por VIN)

Método: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/26811/glass
Parâmetros obrigatórios: vin, parts
Propósito: Recuperar informações detalhadas sobre o vidro do veículo por VIN, incluindo números de peças OEM e de mercado de reposição, especificações, características e ajuste para componentes de vidro.

Exemplo de solicitação:

Exemplo de resposta:

Use isso quando seu fluxo precisar de candidatos a peças imediatamente após o VIN ser escaneado ou digitado—incluindo números de mercado de reposição que podem ser cruzados. O aviso indica que você deve verificar os candidatos a peças contra um catálogo antes de comprar.

Integração mínima: chame o Decodificador de VIN Lite com Python

O trecho abaixo chama o endpoint do Decodificador de VIN Lite, lida com erros HTTP e imprime os principais campos de identidade que você provavelmente mapeará em seus modelos.

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"Erro HTTP: {e} - resposta: {getattr(e.response, 'text', '')}", file=sys.stderr)
sys.exit(1)
except requests.exceptions.RequestException as e:
print(f"Falha na solicitação: {e}", file=sys.stderr)
sys.exit(1)

data = resp.json()

# Mapear campos comumente necessários em sistemas a jusante
print("VIN:", data.get("vin"))
print("Fabricante:", data.get("manufacturer"))
print("Modelo:", data.get("model"))
print("Ano:", data.get("year"))
print("País:", data.get("country"))
print("Região:", data.get("region"))
print("Classe:", data.get("class"))
print("WMI/VDS/VIS:", data.get("wmi"), data.get("vds"), data.get("vis"))

Dicas:

Cache por VIN. Para a maioria dos fluxos de trabalho, os dados de identidade decodificados por VIN são estáveis—armazenar em cache as respostas por VIN pode reduzir buscas repetidas.
Normalize a capitalização onde necessário (por exemplo, nomes de fabricantes) para consistência na exibição.
Se você precisar de atributos mais ricos, mude para o endpoint completo do Decodificador de VIN com o mesmo parâmetro vin e cabeçalho de Autorização.

Curl rápido que você pode executar agora

Copie, cole e substitua YOUR_API_KEY pela sua chave. Este é o exemplo oficial que retorna marca/modelo/ano e mais para um VIN europeu:

Padrões comuns de integração

Pré-preenchimento de formulário: o usuário insere o VIN; você chama o Decodificador de VIN Lite para preencher automaticamente fabricante, modelo e ano. Valide o WMI de três caracteres para verificações de região.
Pré-seleção de pesquisa de peças: decodifique o VIN primeiro, depois chame o endpoint de Vidro com parts=windshield para mostrar candidatos compatíveis antes da navegação no catálogo.
Trabalhos de ingestão de frota: decodifique em lote um CSV de VINs, armazene em cache por VIN e armazene “marca/modelo/ano/corpo” normalizados para análises.
Portões de risco/elegibilidade: use classe, estilo da carroceria (do decodificador completo) e região para direcionar usuários para o plano ou fluxo de trabalho correto.

Notas de manuseio de campo que economizam tempo

O parâmetro VIN é obrigatório em todos os endpoints mostrados aqui. Para Vidro, parts também é obrigatório (por exemplo, parts=windshield).
A autorização é via cabeçalho Authorization: Bearer YOUR_API_KEY em cada solicitação.
As formas de resposta diferem por endpoint; leia os campos específicos que você precisa e proteja com .get() ou equivalente.
Como os atributos decodificados por VIN são estáveis, o armazenamento em cache de curto prazo (por exemplo, por VIN por horas ou dias) reduz chamadas duplicadas sem arriscar a obsolescência.

Chamando a API de agentes de IA via MCP

Se você preferir orquestrar chamadas de um cliente compatível com MCP (Claude Code, Cursor, Windsurf, etc.), aponte sua ferramenta para o endpoint MCP do Zyla e inclua sua chave de API como um parâmetro de consulta na URL do MCP. Seu agente pode então chamar os mesmos endpoints mostrados acima usando os mesmos parâmetros vin e parts, e o cabeçalho de Autorização conforme descrito aqui. Veja o ponto de entrada do MCP:

MCP

Mantenha as URLs dos endpoints exatamente como listadas neste artigo para as chamadas de ferramentas HTTP do agente.

Cenários de teste para verificar antes de enviar

Caminho feliz: VINs conhecidos retornam fabricante/modelo/ano esperados.
Variação regional: teste VINs da América do Norte e da Europa para garantir que seus rótulos de UI não assumam uma única região.
Específico de vidro: verifique se parts=windshield retorna candidatos e adicione uma nota voltada para o usuário sobre a verificação do catálogo ao oferecer pedidos diretos de peças.
Tratamento de erros: simule timeouts e respostas não 2xx; garanta que seu fluxo mostre uma entrada manual de fallback quando a decodificação falhar.

FAQ

Que autenticação é necessária?
Use o cabeçalho HTTP Authorization: Bearer YOUR_API_KEY em cada solicitação.

Quais parâmetros são obrigatórios?
Todos os endpoints mostrados exigem vin. O endpoint de Vidro também exige parts (por exemplo, parts=windshield).

Há um plano gratuito?
A API usa um modelo de assinatura + cota (não pago por chamada). Verifique a página da API para opções de acesso e preços atuais; um teste de 7 dias está disponível na lista.

Posso decodificar VINs não europeus com o endpoint Lite?
O endpoint Lite aceita um parâmetro vin e pode retornar campos de região e país (o exemplo mostra um VIN da América do Norte). Use as saídas do endpoint para ramificar sua lógica adequadamente.

Como devo armazenar resultados em cache?
Armazene em cache por chave VIN. Como os atributos decodificados por VIN são estáveis, armazenar em cache por VIN ajuda a reduzir buscas repetidas durante tentativas de usuário ou processamento em lote.

Envie isso

Pegue sua chave, acesse o endpoint do Decodificador de VIN Lite para essenciais rápidos e faça upgrade para o decodificador completo ou endpoint de Vidro quando precisar de atributos detalhados ou candidatos a peças. Comece agora e mantenha sua integração leve com uma chave de API em mais de 10.000 APIs públicas no Zyla API Hub. O teste de 7 dias começa na lista:

Comece o teste de 7 dias na API do Decodificador de VIN da Europa