Você tem um número. O que você precisa é uma marca, um modelo, uma variante, um acabamento e oito imagens. Transformar um no outro é a parte que ninguém quer construir, então é a parte que construímos.
Chega em um feed de estoque, em um documento de registro, em uma planilha da empresa de leasing.
GET /vin/WVWZZZ1KZAW000000

Alguém digitou no formulário de troca, ou leu no carro que estava na frente deles.
GET /plate/MVI2024?country=DE

Uma pessoa digitou isso em uma caixa de pesquisa, com o espaçamento e o apelido que usou.
GET /api/search?q=fiat%20500%202020

Respostas de exemplo, encurtadas. Os identificadores são placeholders, os veículos e cores ao lado deles são saída real do catálogo.
Três coisas, em um único pedido. A do meio é o motivo pelo qual isso é mais difícil do que parece, e o motivo pelo qual a resposta diz o quão segura ela está.
Um VIN se torna uma marca, modelo, ano, carroceria, motor e câmbio. Uma placa se torna o mesmo, mais o VIN por trás dela e a cor em que o carro foi registrado. Texto livre se torna qualquer entrada de catálogo que as palavras estavam alcançando.
O veículo decodificado é comparado com o catálogo, e a resposta indica o quão bem ele se encaixa. Esse campo existe porque um quase acerto é um resultado normal neste negócio, e você deve ser quem decide o que fazer a respeito.
A mesma resposta traz uma URL de imagem assinada por vista que seu plano permite. Sem uma segunda chamada, sem tabela de mapeamento própria, sem trabalho noturno que reconcilie dois sistemas.
Uma consulta de placa sabe a cor em que o veículo foi registrado, e leva isso para a solicitação de imagem. Assim, uma página de troca de carro mostra o carro que o cliente reconhecerá no estacionamento, e não um substituto genérico prateado que o faz se perguntar se você tem o veículo certo.
Quando uma cor registrada não está no catálogo para aquele modelo, recorre-se ao acabamento padrão e vehicle.color indica o que foi realmente utilizado. Esse campo é o motivo pelo qual uma página pode imprimir "a cor mostrada pode diferir" apenas quando é verdade, em vez de deixar esse aviso sob cada carro para sempre e ensinar as pessoas a desconfiarem das imagens.
Depois da consulta, o veículo correspondente é uma entrada de catálogo comum. Se você quiser em uma pintura diferente, ou em todos os oito ângulos, ou recortado para sua própria cena, isso é o mesmo veículo e os mesmos endpoints de tudo mais neste site.
Associar um carro real a uma entrada de catálogo nem sempre é limpo: facelifts, versões específicas do mercado, uma variante que foi vendida por onze meses. Em vez de esconder isso, a resposta a classifica.
O Reino Unido, a maior parte da Europa, os EUA e um número de outros mercados. As matrículas se repetem em fronteiras, então passe o país quando souber. Sem isso, a consulta tem de adivinhar, e adivinhar é como uma placa britânica se torna uma van holandesa.
Você recebe matched: false e nenhuma imagem, em vez de algo próximo disfarçado de resultado. Um carro errado em um anúncio custa mais do que um espaço vazio.
A decodificação vem dos dados de veículos que licenciamos, a mesma fonte na qual o catálogo é construído. É por isso que os termos da licença podem ser escritos: nada aqui foi raspado de outro site.
Não, são complementos. Sua chave tem ou não tem, e GET /api/me diz quais. Peça-nos e ativamos.
Sim. A consulta preenche a cor registrada porque é geralmente o que você deseja, mas o veículo que foi correspondido é uma entrada de catálogo comum depois. Peça-o em qualquer pintura que o modelo carregue.
Reais do seu próprio estoque ou dos seus próprios formulários de troca. Passamos por eles e enviamos de volta o que saiu, incluindo os que não corresponderam, pois esse número diz mais sobre se isso funciona para você do que os que corresponderam.