Adicional da API v2
Estilo de vida: resolver uma imagem
GET/api/{brand}/{model}/{year}/{variant}/{trim}/lifestyle/{scene}/{image}
Adicionar API v2 — chaves com acesso v2. Uma imagem de estilo de vida com um image_url assinado. As imagens de estilo de vida são cenas completas: elas sempre preenchem o quadro (fit=cover), um background não se aplica (erro B32). Tinta (color), lights, size, ratio e format funcionam como em qualquer lugar.
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. |
scene obrigatório | string | Cena. |
image obrigatório | string | Imagem da cena (veja *Lifestyle: imagens de uma cena*). |
Parâmetros de consulta
| Nome | Tipo | Descrição |
|---|---|---|
format | string | Formato de entrega. pngwebpjpegavifauto |
ratio | string | Proporção de aspecto (recortada para preencher). 1:14:33:216:916:102:121:95:43:44:52:39:16 |
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 |
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`. |
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 |
