APIs de Dados de Veículos no Zyla API Hub: Decodificação de VIN, Placas e Vidros

O Zyla API Hub possui várias APIs de dados de veículos. Elas não são um único produto com dez nomes. Elas são trabalhos diferentes: decodificar um VIN de 17 caracteres em especificações do fabricante, resolver uma placa quando você não tem o VIN, procurar números de peças de vidro ou decodificar uma motocicleta. Este é um mapa dessas abordagens e os endpoints ao vivo.

O catálogo é mais de 10.000 APIs públicas. Você se inscreve por listagem (mensal ou anual, com uma cota incluída). Não há Plano Gratuito. Sua primeira API do Hub inclui um teste gratuito de 7 dias (até 50 solicitações). O suporte de primeiro nível intermedia com o provedor. Listagens que falham no monitoramento contínuo são descontinuadas.

O que é um decodificador de VIN — e o que não é

Uma decodificação de VIN retorna identidade e especificações: fabricante, modelo, ano do modelo, motor, combustível, classe da carroceria, planta. Não é um relatório estilo Carfax. Não retorna acidentes, roubo, marcas de título ou proprietários anteriores. Essa discrepância é o ticket de suporte mais comum nessas listagens. Se você precisa de histórico, essa é uma família de produtos diferente — não a API de Decodificação de VIN e Especificações de Veículos.

A cobertura dos EUA é tipicamente mais rica do que a da Europa ou do mundo. Várias listagens do Hub compartilham o mesmo backend de decodificação de primeira parte. Escolha a listagem que corresponde à geografia para a qual você se inscreveu; não se inscreva em três clones para o mesmo VIN.

1. Decodificação de VIN — escolha uma geografia

A listagem principal é a API de Decodificador de VIN. Uma assinatura, cinco endpoints:

Decodificador de VIN dos EUA — exemplo de VIN JTMZ431V10D144875. Cobertura de especificações mais forte.
Decodificador de VIN da Europa — exemplo de docs WVWZZZAUZEW389248.
Decodificador de VIN do Mundo — mesma função, mundial, campos mais finos.
Decodificador de VIN Lite — carga menor (exemplo de docs 1C4NJPBB3FD398798).
Vidro — vidro OEM / de reposição por VIN e peça (veja abaixo).

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder?vin=JTMZ431V10D144875"

Exemplo de docs oficial para esse VIN (campos selecionados):

{
"Make": "TOYOTA",
"Manufacturer Name": "TOYOTA MOTOR CORPORATION",
"Model": "RAV4",
"Trim": "LE (X Grade)",
"Vehicle Type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
"Body Class": "Sport Utility Vehicle [SUV]/Multipurpose Vehicle [MPV]",
"Doors": "5",
"Drive Type": "4x2",
"VIN": "JTMZ431V10D144875"
}

O mesmo backend serve a API de Decodificador de VIN da Europa e a API de Decodificação de VIN.

Se você só precisa da Europa, inscreva-se na API de Decodificador de VIN da Europa em vez da API de Decodificador de VIN. Os endpoints lá: Decodificador de VIN (exemplo de docs WVWZZZ3BZWE689725), Lite e Vidro. O caminho da Europa na API de Decodificador de VIN usa WVWZZZAUZEW389248; exemplo de docs oficial:

{
"Make": "Volkswagen",
"Model": "Golf",
"Model year": "2012",
"Vehicle class": "Compact Car",
"Vehicle type": "Passenger car",
"Manufactured in": "Germany",
"Manufacturer": "Volkswagen AG",
"Number of doors": "5",
"Driveline": "2WD",
"VIN": "WVWZZZAUZEW389248"
}

Decodificador de VIN Lite é a carga menor. Exemplo de docs oficial para 1C4NJPBB3FD398798:

{
"vin": "1C4NJPBB3FD398798",
"country": "United states (usa)",
"manufacturer": "Jeep",
"model": "Patriot",
"class": "Sport Utility Vehicle (SUV)/Multi-Purpose Vehicle (MPV)",
"region": "North America",
"year": "2015"
}

2. Decodificação estruturada de primeira parte

A API de Decodificador de Identificação de Veículos é a listagem limpa de dados governamentais: um endpoint, uma consulta obrigatória, nenhuma chave de origem extra no contrato público.

Decodificar Identificação de Veículo — exemplo oficial vin=1HGCM82633A004352 (as letras I, O, Q nunca aparecem). Campos documentados: fabricante, modelo, ano do modelo, fabricante, tipo de veículo, classe da carroceria, país da planta, cilindros do motor, tipo de combustível, série, acabamento, portas, além de um veredicto de validade.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://zylalabs.com/api/13156/vehicle-identification-decoder-api/26702/decode-vehicle-identification?vin=1HGCM82633A004352"

Exemplo de docs oficial:

{
"valid": true,
"vin": "1HGCM82633A004352",
"decoded": {
"vin": "1HGCM82633A004352",
"make": "HONDA",
"model": "Accord",
"model_year": "2003",
"manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
"vehicle_type": "PASSENGER CAR",
"body_class": "Coupe",
"plant_country": "UNITED STATES (USA)",
"engine_cylinders": "6",
"fuel_type": "Gasoline",
"series": null,
"trim": "EX-V6",
"doors": "2"
},
"error_text": "0 - VIN decoded clean. Check Digit (9th position) is correct",
"source": "NHTSA vPIC (U.S. DOT, public domain)"
}

Use isso quando você quiser uma única forma JSON estável. Use a API de Decodificador de VIN ou a API de Decodificador de VIN da Europa quando você já depender da divisão EUA / Europa / Mundo / Lite.

3. Decodificação apenas dos EUA, incluindo motocicletas

A API de Decodificador de VIN dos EUA é a listagem com peso dos EUA: Decodificador Mundial, Decodificador de VIN dos EUA, Decodificador de VIN de Motocicleta, Lite e Vidro.

Listagens dedicadas para motos também existem — a API de Decodificador de VIN de Motocicleta — se motocicletas forem o único tráfego que você enviará.

4. Vidro por VIN

Várias listagens de decodificação expõem um endpoint de Vidro: passe o VIN e um valor de parts (windshield, rear_window, driver_side_window, passenger_side_window, rear_left_window, rear_right_window, sunroof, moonroof). A resposta é números de peças OEM e de reposição e adequação — não uma decodificação de fabricante/modelo.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://zylalabs.com/api/74/vin-decoder-api/26619/glass?vin=WVWZZZAUZEW389248&parts=windshield"

Exemplo de docs oficial:

{
"vin": "WVWZZZAUZEW389248",
"make": "Volkswagen",
"model": "Golf",
"year": "2012",
"glass": {
"windshield": [
{
"oem_part_number": "5K0845011",
"aftermarket_part_number": "FY2847",
"glass_type": "Laminated Safety Glass",
"features": "Green tinted, UV protection, compatible with rain sensor, antenna embedded"
}
]
},
"match": "candidates"
}

Mesmo enum de parts no endpoint de Vidro da API de Decodificador de VIN da Europa e nas listagens de placa para VIN abaixo.

5. Placa de licença → veículo (quando você não tem o VIN)

Diferentes países, diferentes contratos. Não envie uma placa francesa para uma API de placa dos EUA.

Obter VIN da API de Placa de Licença — Apenas EUA — 50 estados. Chame Obter Estados primeiro (as strings de estado devem corresponder àquela lista), depois Obter Detalhes do VIN. Exemplo de docs: license_plate=8UZS701, state=california.
API de Placa de Licença da França — SIV Oficial — um endpoint, consulta plaque (exemplo de docs FH034DD). Registro oficial francês (SIV), não uma decodificação de VIN dos EUA.
API de Consulta de Placa de Licença da Itália — placa para dentro, arquivo de veículo para fora. Inscreva-se apenas se a Itália for o trabalho.
API de Validador de Registro da Austrália — registro + estado → detalhes do veículo. Permanece no Hub como sua própria listagem (rego, não um VIN de 17 caracteres).

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://zylalabs.com/api/87/get-vin-from-license-plate-api-us-only/143/get-vin-details?license_plate=8UZS701&state=california"

Exemplo de docs oficial (campos selecionados):

{
"Make": "AUDI",
"Model": "SQ7",
"Model Year": "2021",
"VIN": "WA1AWBF75MD010938",
"License Plate": "8UZS701",
"Drive Type": "AWD/All-Wheel Drive",
"Doors": "4",
"Number of Seats": "7"
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://zylalabs.com/api/6418/france-license-plate-api-official-siv-vehicle-data/9216/identify-french-vehicle-by-license-plate?plaque=FH034DD"

Exemplo de docs oficial (SIV tem muitos mais campos; estes são os de identidade):

{
"code": 200,
"country": "FR",
"query": "FH034DD",
"error": false,
"message": "Succès",
"data": {
"AWN_VIN": "VF1R9800962986572",
"AWN_immat": "FH034DD",
"AWN_marque": "RENAULT",
"AWN_modele": "CLIO",
"AWN_label": "CLIO IV PHASE 2 - 5P 2016-08->2020-03",
"AWN_version": "1.5 DCI 90 TREND",
"AWN_energie": "GAZOLE",
"AWN_carrosserie": "BERLINE",
"AWN_date_mise_en_circulation": "20-06-2019"
}
}

Como escolher

Você tem um VIN e precisa de especificações. A API de Decodificador de Identificação de Veículos para uma decodificação estruturada, ou a API de Decodificador de VIN se você quiser EUA / Europa / Mundo / Lite / Vidro em uma chave.
Tráfego de VIN apenas da Europa. A API de Decodificador de VIN da Europa.
Você tem uma placa, não um VIN. A Obter VIN da API de Placa de Licença — Apenas EUA, a API de Placa de Licença da França — SIV Oficial, a API de Consulta de Placa de Licença da Itália, ou a API de Validador de Registro da Austrália.
Para para-brisa / peças de vidro. Vidro na listagem de decodificação à qual você já se inscreveu — não adicione uma segunda API de decodificação apenas para parts=windshield.
Apenas motocicletas. A API de Decodificador de VIN de Motocicleta, ou o endpoint de motocicleta na API de Decodificador de VIN dos EUA.
Acidentes, roubo, título. Nenhuma das listagens acima. Não teste um decodificador esperando um relatório de histórico.

PHP: Decodificação dos EUA

$vin = 'JTMZ431V10D144875';
$ch = curl_init('https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder?vin=' . rawurlencode($vin));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ZYLA_API_KEY')],
]);
$json = curl_exec($ch);
curl_close($ch);
$car = json_decode($json, true);
echo ($car['Make'] ?? '') . ' ' . ($car['Model'] ?? '') . ' ' . ($car['Trim'] ?? '');

Crie uma conta no Hub, inscreva-se em uma listagem e chame o endpoint que corresponde ao identificador que você realmente possui — VIN, placa dos EUA ou placa estrangeira.