Adicional da API v2
Giro de 360°: todos os quadros de um anel
GET/api/{brand}/{model}/{year}/{variant}/{trim}/360/{ring}
Adicionar API v2 — chaves com acesso v2. Cada frame de um anel em ordem, cada um com seu próprio image_url assinado e seu ângulo: um visualizador de rotação precisa de todos eles. As opções de imagem (formato, largura, cor, fundo) se aplicam a cada frame, então uma rotação é sempre consistente.
Parâmetros de caminho
| Nome | Tipo | Descrição |
|---|---|---|
brand obrigatório | string | Nome da marca (nomenclatura de catálogo atualizada para carros adicionais). |
model obrigatório | string | Nome do modelo |
year obrigatório | integer. | Ano do modelo (4 dígitos). Se o ano exato estiver ausente, a geração mais próxima disponível é usada (nota de erro `Y01`). |
variant obrigatório | string | Variante de carroceria. |
trim obrigatório | string | Nível de acabamento. |
ring obrigatório | string | Ring: eye_level, baixo ou alto (veja *360° spin: rings*). |
Parâmetros de consulta
| Nome | Tipo | Descrição |
|---|---|---|
format | string | Formato de entrega. pngwebpjpegavifauto |
width | integer. | Largura em px. |
color | string | Pintura: nome da cor do catálogo, hexadecimal de 6 dígitos ou `<finish>_<hex>` (por exemplo, `metallic_315fbf`). |
color_id | integer. | Cor de tinta pelo seu id de `/api/colors`. Use quando um nome existe mais de uma vez: o id é único e nunca muda. Tem prioridade sobre `color`; `0` é a tinta original. Id desconhecido ou inativo → mesmo que um nome desconhecido (tinta padrão + nota de erro `F04`). |
lights | string | **Adicional da API v2:** faróis ligados ou desligados. **Padrão `on`:** sem o parâmetro a imagem vem com as luzes acesas onde a imagem as tiver; envie `lights=off` para uma imagem sem luzes. Uma imagem sem variante de luz simplesmente vem sem luzes; com `lights=on` ela também carrega o erro `L26`. onoff |
background | string | **API v2 add-on:** `white` (padrão), `transparent`, ou uma cor hexadecimal de 6 dígitos como `f4f4f4`. Apenas imagens de estúdio (lifestyle → erro `B32`). |
windows | string | **API v2 add-on:** `see_through` = vidro como na imagem (padrão), `dark` = vidro privativo que não se vê através. Não disponível → erro `W28`. see_throughdark |
plate | string | **API v2 add-on:** placa de licença — `none` = como na imagem (padrão), `blank` = placa vazia, `logo` = seu logo na placa (configurado em sua chave; ausente → branco + notanota de erro `N30`), `text` = seu próprio texto de `plate_text` (deve ser habilitado para sua chave, veja `addon.plate_text` em `/api/me`; caso contrário, notanota de erro `O31`). noneblanklogotext |
plate_text | string | **API v2 add-on:** o texto para `plate=text` — até 10 caracteres: letras, dígitos, espaços e `-` `.` `&`. Escrito na placa conforme enviado (maiúsculas e minúsculas mantidas), centralizado e tão grande quanto a placa permite. Ausente, muito longo ou outros caracteres → `400`. |
fit | string | **API v2 add-on:** como o carro preenche uma caixa `ratio` / `size` — `contain` preenche (padrão), `cover` recorta. Imagens lifestyle sempre cobrem. containcover |
size | string | **Adicionar ao API v2:** lado mais longo: `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` prevalecem sobre `size`. 2k1080p720p540p360pthumb |
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 |
