Imagem

Uma imagem por modelo

GET/api/{brand}/{model}/image

Uma imagem representativa de um modelo sem saber o ano, estilo de carroceria ou versão, por exemplo, para um seletor de modelo. /api/{brand}/{model}/modelimage é o mesmo endpoint.

O carro é escolhido por uma regra fixa, então o mesmo modelo sempre retorna o mesmo carro: o ano mais recente, o estilo de carroceria mais comum desse ano, o acabamento base (caso contrário, o primeiro), e a visão front_left (caso contrário, a primeira visão externa que seu plano permite). Restrinja com year, variant ou view.

A resposta é exatamente a resposta da imagem de visão única do carro escolhido: id, year, variant e trim informam qual é, para que você possa continuar com o catálogo ou /api/id/{id}. Todas as opções de imagem (format, width, color, …) se aplicam, e ele conta como qualquer imagem única.

Parâmetros de caminho

NomeTipoDescrição
brand obrigatório string Nome da marca — veja /api/brands.
model obrigatório string Nome do modelo — veja /api/{brand}.

Parâmetros de consulta

NomeTipoDescrição
year integer. Use a geração deste ano em vez do mais recente (mesma regra do catálogo).
variant string Apenas este estilo de carroceria (nomes equivalentes como `Kombi` / `Estate` funcionam como no catálogo).
view string Outra visão que não `front_left` — veja /api/views.
version string Resultados de apenas uma versão: `v1` = imagens padrão, `v2` = add-on da API v2 (sem recair nas imagens padrão). Sem ele: tudo o que sua chave permite. Não permitido para sua chave → `403`. v1v2