Complemento de API v2
Estilo de vida: resolver una imagen
OBTENER/api/{brand}/{model}/{year}/{variant}/{trim}/lifestyle/{scene}/{image}
API v2 add-on — claves con acceso a v2. Una imagen de estilo de vida con un image_url firmado. Las imágenes de estilo de vida son escenas completas: siempre llenan el marco (fit=cover), un background no se aplica (errornote B32). Pintura (color), lights, size, ratio y format funcionan como en todas partes.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
brand requerido | cadena | Nombre de la marca (nombres de catálogo actualizados para los coches adicionales). |
model requerido | cadena | Nombre del modelo. |
year requerido | integer | Año del modelo (4 dígitos). Si falta el año exacto, se usa la generación más cercana disponible (nota de error `Y01`). |
variant requerido | cadena | Variante de carrocería. |
trim requerido | cadena | Nivel de acabado. |
scene requerido | cadena | Escena. |
image requerido | cadena | Imagen de la escena (ver *Lifestyle: imágenes de una escena*). |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
format | cadena | Formato de entrega. pngwebpjpegavifauto |
ratio | cadena | Relación de aspecto (recortado para llenar). 1:14:33:216:916:102:121:95:43:44:52:39:16 |
color | cadena | Pintura: nombre del color del catálogo, hexadecimal de 6 dígitos o `<finish>_<hex>` (por ejemplo, `metallic_315fbf`). |
color_id | integer | Color de pintura por su id desde `/api/colors`. Úsalo cuando un nombre existe más de una vez: el id es único y nunca cambia. Tiene prioridad sobre `color`; `0` es la pintura original. Id desconocido o inactivo → igual que un nombre desconocido (pintura predeterminada + nota de error `F04`). |
lights | cadena | **API v2 complemento:** faros encendidos o apagados. **Predeterminado `on`:** sin el parámetro la imagen viene con las luces encendidas dondequiera que la imagen las tenga; envíe `lights=off` para una imagen sin luces. Una imagen sin variante de luz simplemente viene sin luces; con `lights=on` también lleva la notificación de error `L26`. onoff |
windows | cadena | **API v2 complemento:** `see_through` = vidrio como en la imagen (predeterminado), `dark` = vidrio de privacidad que no se puede ver a través. No disponible → errornote `W28`. see_throughdark |
plate | cadena | **API v2 complemento:** placa de licencia — `none` = como en la imagen (predeterminado), `blank` = placa vacía, `logo` = su logo en la placa (configurado en su clave; si falta → vacía + notadeerror `N30`), `text` = su propio texto de `plate_text` (debe estar habilitado para su clave, consulte `addon.plate_text` en `/api/me`; de lo contrario, notadeerror `O31`). noneblanklogotext |
plate_text | cadena | **API v2 complemento:** el texto para `plate=text` — hasta 10 caracteres: letras, dígitos, espacios y `-` `.` `&`. Se escribe en la placa como se envía (se mantienen las mayúsculas y minúsculas), centrado y tan grande como lo permita la placa. Falta, demasiado largo o caracteres distintos → `400`. |
size | cadena | **API v2 complemento:** lado más largo — `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` prevalecen sobre `size`. 2k1080p720p540p360pthumb |
hotspots | cadena | **API v2 complemento:** añadir `hotspots` a la respuesta — puntos de interés (llantas, faros …) como fracciones 0–1 de la imagen, por ejemplo, para visualizadores interactivos. true |
version | cadena | Resultados de una sola versión: `v1` = imágenes estándar, `v2` = complemento de la API v2 (sin retroceso a las imágenes estándar). Sin él: todo lo que permita tu clave. No permitido para tu clave → `403`. v1v2 |
