Você tem um VIN de 17 caracteres de um veículo dos EUA e precisa de marca, modelo, ano, motor e especificações de construção relacionadas rapidamente. Ao final deste artigo, você será capaz de chamar um endpoint real de decodificação de VIN no Zyla API Hub, analisar a resposta e integrá-la ao seu aplicativo, webhook ou ferramenta interna esta semana.
O que esta API faz e quando usá-la
A API Decodificador de VIN no Zyla API Hub expõe múltiplos endpoints somente leitura para transformar um VIN em especificações do fabricante. O endpoint Decodificador de VIN dos EUA retorna marca, modelo, ano e outros atributos de fábrica quando disponíveis na fonte. Não retorna histórico de acidentes, registros de roubo, marcas de título ou dados de proprietários anteriores. A cobertura é mais forte para VINs dos EUA; endpoints da Europa e do Mundo também estão disponíveis, com campos potencialmente mais limitados.
Casos de uso típicos incluem:
- Entrada de mercado automotivo: normalizar listagens com marca/modelo/versão verificados.
- Formulários de cotação de seguro: preencher automaticamente classe do carro, portas e sistema de tração a partir de um VIN.
- Gerenciamento de inventário de frotas: padronizar metadados de veículos na integração.
- Fluxos de busca de peças: mapear VIN para notas de série/versão para filtragem de compatibilidade.
Você pode acessar todas as APIs no Zyla API Hub com uma conta, uma chave de API e um modelo de assinatura + cota. O marketplace hospeda mais de 10.000 APIs públicas em várias categorias se você precisar adicionar enriquecimento mais tarde sem novos fluxos de autenticação.
Começando no Zyla API Hub
Abra a listagem da API Decodificador de VIN no Zyla API Hub, inicie o teste ou assine, e pegue sua chave. A autenticação é feita via cabeçalho Authorization usando seu token bearer. A primeira API à qual você se inscreve geralmente oferece um teste de 7 dias ou 50 solicitações; não há Plano Gratuito. Para opções de acesso e preços atuais, use a página de listagem.
Iniciar teste de 7 dias na API Decodificador de VIN
Endpoints que você pode chamar
Todos os endpoints abaixo são GET. Inclua sua chave de API no cabeçalho Authorization como “Bearer YOUR_API_KEY”. Apenas os parâmetros mostrados aqui são suportados; não adicione outros.
Decodificador de VIN dos EUA
Envie um VIN de 17 caracteres e receba especificações do fabricante: marca, modelo, ano, motor e transmissão quando a fonte os reportar. A cobertura dos EUA é tipicamente mais rica do que a da Europa ou do Mundo.
- Método: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder
- Parâmetro de consulta obrigatório:
- vin: JTMZ431V10D144875
Exemplo de cURL (copie e cole e substitua YOUR_API_KEY se necessário):
curl -s -X GET "https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder?vin=JTMZ431V10D144875" \
-H "Authorization: Bearer YOUR_API_KEY"Exemplo de resposta:
{
"Suggested VIN": "JTMZ431V1!D144875",
"Error Code": "1,11,14,400",
"Vehicle Descriptor": "JTMZ431V*0D",
"Make": "TOYOTA",
"Manufacturer Name": "TOYOTA MOTOR CORPORATION",
"Model": "RAV4",
"Plant City": "OHBU",
"Series": "ASA33L/ASA38L/GSA33L/GSA38L",
"Trim": "LE (X Grade)",
"Vehicle Type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
"Plant Country": "JAPAN",
"Plant Company Name": "Toyota Industries Corporation, Nagakusa Plant",
"Plant State": "AICHI",
"Trim2": "X Grade",
"Series2": "Wagon body style",
"Note": "Without Third Seat",
"NCSA Body Type": "Compact Utility (Utility Vehicle Categories Small and Midsize )",
"NCSA Make": "Toyota",
"NCSA Model": "RAV4 *",
"Body Class": "Sport Utility Vehicle [SUV]/Multipurpose Vehicle [MPV]",
"Doors": "5",
"Drive Type": "4x2",
"Gross Vehicle Weight Rating From": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
"Trailer Type Connection": "Not Applicable",
"Trailer Body Type": "Not Applicable",
"Bus Floor Configuration Type": "Not Applicable",
"Bus Type": "Not Applicable",
"Custom Motorcycle Type": "Not Applicable",
"Motorcycle Suspension Type": "Not Applicable",
"Motorcycle Chassis Type": "Not Applicable",
"VIN": "JTMZ431V10D144875"
}O que observar primeiro:
- Marca, Modelo, Tipo de Veículo, Classe do Carro: para exibição de UI e filtros de busca.
- Portas e Tipo de Tração: para seguros, mercado e fluxos de serviço.
- Série/Versão/Série2/Versão2/Nota: para ajuste de peças e recursos específicos de versão.
- “VIN Sugerido” mais “Código de Erro”: dicas de correção potenciais e códigos de status quando o VIN inclui problemas ou caracteres não padrão.
Decodificador de VIN da Europa
Decodifique VINs da Europa. A disponibilidade de dados pode ser mais limitada do que as respostas dos EUA.
- Método: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/1507/europe-vin-decoder
- Parâmetro de consulta obrigatório:
- vin: WVWZZZAUZEW389248
Exemplo de cURL:
Exemplo de resposta:
Decodificador de VIN do Mundo
Decodifique VINs de fabricantes ao redor do globo. A disponibilidade de dados pode ser limitada em comparação com os EUA.
- Método: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/1508/world-vin-decoder
- Parâmetro de consulta obrigatório:
- vin: WVWZZZAUZEW389248
Exemplo de cURL:
Exemplo de resposta:
Exemplo rápido em Python usando o endpoint dos EUA
Este trecho chama o Decodificador de VIN dos EUA, falha rapidamente em não-200 e extrai os campos que você provavelmente renderizará em um formulário ou listagem. Substitua YOUR_API_KEY antes de executar.
import requests
API_URL = "https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder"
API_KEY = "YOUR_API_KEY" # defina sua chave
VIN = "JTMZ431V10D144875"
resp = requests.get(
API_URL,
params={"vin": VIN},
headers={"Authorization": f"Bearer {API_KEY}"}
)
resp.raise_for_status()
data = resp.json()
# Payload de exibição mínima
vehicle = {
"vin": data.get("VIN"),
"make": data.get("Make"),
"model": data.get("Model"),
"vehicle_type": data.get("Vehicle Type"),
"body_class": data.get("Body Class"),
"doors": data.get("Doors"),
"drive_type": data.get("Drive Type"),
"series": data.get("Series"),
"trim": data.get("Trim"),
"note": data.get("Note"),
}
print(vehicle)
# Diagnósticos / dicas de correção opcionais
suggested = data.get("Suggested VIN")
error_code = data.get("Error Code")
if suggested or error_code:
print({"suggested_vin": suggested, "error_code": error_code})Comportamento, respostas e notas de integração que economizam tempo
- Autenticação: Adicione Authorization: Bearer YOUR_API_KEY a cada solicitação.
- Unidades e formatos:
- Classes de peso nas respostas dos EUA aparecem como intervalos legíveis por humanos (por exemplo, “Classe 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)”). Não assuma apenas numérico.
- Campos como “Portas” e “Tipo de Tração” podem ser strings; normalize se você exigir valores apenas numéricos.
- Tratamento de erros:
- Se “Código de Erro” aparecer, trate-o como uma string de status/contexto do decodificador. Considere registrá-lo para analisar a qualidade da entrada do VIN.
- “VIN Sugerido” pode ajudar a exibir UI de correção do usuário quando um caractere é ambíguo ou digitado incorretamente.
- Presença de campo: Nem todo VIN retorna todos os campos. Sempre verifique nulos em atributos opcionais (por exemplo, Série2, Versão2, Nota).
- Cache: Metadados de VIN são estáticos para um veículo. Armazene por VIN indefinidamente em seu aplicativo ou CDN para evitar chamadas desnecessárias.
- Taxa de transferência: O Zyla API Hub usa um modelo de assinatura + cota, não pagamento por chamada. A primeira API que você adiciona geralmente inclui um teste de 7 dias ou 50 solicitações para avaliação. Verifique a listagem para os detalhes do seu plano atual.
Escolhendo entre endpoints dos EUA, Europa e Mundo
Se você lida principalmente com veículos dos EUA, use o endpoint dos EUA para os atributos mais ricos. Se seus VINs abrangem várias regiões, você pode direcionar pelo WMI (primeiros 1–3 caracteres) ou tentar endpoints específicos da região primeiro, voltando para o Mundo. A tabela abaixo resume as principais diferenças.
| Endpoint | HTTP | Caminho | Parâmetro VIN | Nota sobre disponibilidade de dados |
|---|---|---|---|---|
| Decodificador de VIN dos EUA | GET | /api/74/vin-decoder-api/139/usa-vin-decoder | vin | A cobertura dos EUA é tipicamente mais rica do que outras regiões. |
| Decodificador de VIN da Europa | GET | /api/74/vin-decoder-api/1507/europe-vin-decoder | vin | A disponibilidade de dados pode ser limitada em comparação com os Estados Unidos. |
| Decodificador de VIN do Mundo | GET | /api/74/vin-decoder-api/1508/world-vin-decoder | vin | A disponibilidade de dados pode ser limitada em comparação com os Estados Unidos. |
Casos de uso práticos que você pode implementar esta semana
- Aprimorador de listagem de mercado:
- Na criação de listagem, chame o endpoint dos EUA com o VIN e bloqueie os campos Marca/Modelo/Portas/Classe do Carro. Exiba Versão e Série como tags verificadas somente leitura.
- Armazene “VIN Sugerido” e mostre um aviso leve na UI se diferir do VIN inserido para evitar registros de inventário ruins.
- Formulários de agendamento de serviço:
- Preencha automaticamente a classe do carro e o sistema de tração nas UIs de agendamento. Use “Nota” e “Série2” para destacar texto de aviso de compatibilidade para certos serviços.
- Compatibilidade de peças:
- Mapeie Série e Versão para as categorias do seu catálogo de peças. Armazene resultados para reduzir chamadas repetidas ao decodificador durante a navegação.
- Integração de frotas:
- Ingestão em massa de VINs e enriqueça cada registro de veículo à medida que é escaneado. Persista as especificações decodificadas e exponha Marca/Modelo/Tipo de Tração para relatórios posteriores.
Chamando o Decodificador de VIN de um agente de IA via MCP
Se você preferir orquestrar chamadas através de um agente de IA, a Zyla fornece um endpoint compatível com MCP que funciona com clientes populares. Aponte seu agente para:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Após configurar seu cliente, o agente pode chamar a mesma API Decodificador de VIN que você viu acima de dentro do seu ambiente de codificação. Para detalhes sobre configuração e ferramentas do MCP, consulte a documentação do MCP. Como as solicitações do MCP ainda consomem sua cota de assinatura, reutilize resultados de VIN em cache dentro da sessão do agente para evitar buscas duplicadas.
Lista de verificação de produção
- Valide o comprimento do VIN (17 caracteres) do lado do cliente para cortar chamadas desperdiçadas.
- Registre e monitore ocorrências de “Código de Erro” por formulário de origem ou parceiro para detectar problemas de qualidade de dados precocemente.
- Estratégia de fallback: Se você processar VINs internacionais, tente o endpoint regional primeiro (por exemplo, EUA, depois Europa), e então o Mundo como um catchall.
- Armazene respostas decodificadas por VIN sem expiração e adicione uma opção de atualização manual para equipes de suporte.
- Remova PII: as respostas contêm apenas dados de construção do veículo; seguro para armazenar em bancos de dados de produtos.
FAQ
A API Decodificador de VIN fornece histórico de acidentes ou propriedade?
Não. Os endpoints retornam especificações do fabricante (por exemplo, Marca, Modelo, Classe do Carro, Portas) quando disponíveis. Eles não incluem histórico de acidentes, registros de roubo, marcas de título ou dados de proprietários anteriores.
Que autenticação é necessária?
Use Authorization: Bearer YOUR_API_KEY em cada solicitação. Obtenha sua chave na listagem da API após se inscrever ou iniciar um teste.
Há um plano gratuito?
Não há Plano Gratuito. A primeira API que você adiciona geralmente inclui um teste de 7 dias ou 50 solicitações para avaliação. Verifique a listagem para opções de acesso e preços atuais.
Qual endpoint devo usar para carros dos EUA?
Use o endpoint Decodificador de VIN dos EUA para VINs dos EUA; geralmente retorna o conjunto mais rico de atributos. Para VINs europeus ou de outras regiões, use os endpoints da Europa ou do Mundo, observando que os dados podem ser mais limitados.
Como devo lidar com VINs malformados?
Valide o comprimento antes de chamar. Se a resposta incluir “VIN Sugerido” ou um “Código de Erro”, exiba isso para seus usuários para corrigir erros de digitação ou caracteres ambíguos, e registre o evento para QA.
Pronto para decodificar seu primeiro VIN e integrá-lo ao seu aplicativo? Crie sua conta no Zyla API Hub, obtenha sua chave de API e comece o teste aqui: Iniciar teste de 7 dias na API Decodificador de VIN.
