Um VIN ou uma placa entra; o veículo, o carro correspondente e suas imagens saem. As respostas abaixo são exemplos no formato da API.
Ela chega em um feed de estoque, em um documento de registro ou em uma planilha da empresa de leasing. Dezessete caracteres se tornam o veículo e suas imagens.
GET /api/vin/W1N0G8EB0RF000000
{
"make": "Mercedes-Benz",
"model": "GLC",
"year": 2026,
"body": "SUV",
"engine": { "fuel": "electric", … },
"vehicle": {
"matched": true,
"confidence": "high",
"model": "GLC EQ",
"images": { "front_left": "https://cdn…", … }
}
}
Alguém digitou no formulário de troca ou leu no carro da frente. A placa vira o veículo, seu VIN, e imagens na cor em que está registrado.
GET /api/plate/BKS2024?country=DE
{
"make": "Kia",
"model": "Sportage",
"year": 2024,
"colour": "White",
"vin": "U5YPV81CBRL000000",
"vehicle": {
"matched": true,
"confidence": "high",
"color": "white",
"images": { "front_left": "https://cdn…", … }
}
}
Uma solicitação, três coisas na resposta. Nenhuma segunda chamada, nenhuma tabela de mapeamento própria.
Marca, modelo, ano, acabamento, carroceria, motor, câmbio e tração. Uma placa adiciona o VIN atrás dela e a cor em que está registrada.
O carro mais próximo no nosso catálogo, da geração que cobre o ano do veículo, e uma confiança de quão próximo é.
Uma URL de imagem assinada por visualização que seu plano permite. De uma placa, o carro retorna em sua cor registrada, onde quer que o levemos.
Toda resposta diz como o carro do catálogo se encaixa, pois um quase acerto é um resultado normal neste negócio. Você decide o que fazer com isso.
highO carro do catálogo é o veículo. Publique-o.mediumO modelo certo, com algo incerto abaixo, como uma variante ou ano de facelift. Ótimo para um thumbnail de lista, vale um olhar antes da imagem principal.lowO carro mais próximo que temos. Trate-o como uma sugestão, e considere mostrar nada em vez disso.O Reino Unido, a maior parte da Europa, os EUA e um número de outros mercados; alguns países restringem consultas de registro por lei. Passe o país quando souber. Sem ele, a consulta assume o Reino Unido.
Você recebe matched: false e nenhuma imagem, juntamente com os dados decodificados. Um carro errado em um anúncio custa mais do que um espaço vazio.
A partir de uma placa, sim, onde quer que tenhamos essa cor para o carro. Cores que não carregamos caem para o acabamento padrão, e vehicle.color sempre diz qual foi usado.
Não, são add-ons. Sua chave tem ou não tem, e GET /api/me diz quais. Peça e nós ativamos. Ambos os endpoints estão em beta e ainda ganhando cobertura.
Sim. O carro correspondente é uma entrada comum de catálogo, então você pode solicitá-lo em qualquer cor OEM ou personalizada, com seu logotipo na placa e em todos os ângulos.
Envie-nos alguns VINs ou placas do seu estoque. Passamos por consulta e devolvemos o que sai, incluindo dados do veículo e imagens
