Adicional da API v2
Imagem de grupo de estúdio por id
GET/api/id/{id}/{group}/{image}
Adicionar API v2 — chaves com acesso v2. Igual a *Resolver uma imagem de grupo de estúdio*, mas endereçado pelo id estável do carro, em vez dos seus nomes. GET /api/id/{id}/{group} lista as imagens de um grupo. Carros que existem apenas no adicionar têm ids a partir de 900000000.
Parâmetros de caminho
| Nome | Tipo | Descrição |
|---|---|---|
id obrigatório | integer. | ID de configuração estável. |
group obrigatório | string | Grupo de estúdio: hero, direcionado, extra, drone. |
image obrigatório | string | Imagem do grupo |
Parâmetros de consulta
| Nome | Tipo | Descrição |
|---|---|---|
format | string | Formato de entrega. pngwebpjpegavifauto |
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 |
hotspots | string | **API v2 add-on:** adicione `hotspots` à resposta — pontos de interesse (rodas, faróis ...) como frações 0–1 da imagem, por exemplo, para visualizadores interativos. true |
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 |
