Complemento de API v2
Resolver una imagen de grupo de estudio
OBTENER/api/{brand}/{model}/{year}/{variant}/{trim}/{group}/{image}
API v2 add-on — claves con acceso a v2. Una imagen de un grupo de estudio: hero (tomas heroicas, algunas desde el nivel del suelo), steered (ruedas delanteras giradas), extra (más ángulos desde tres alturas de cámara, esquinas también a 30° y 45°), drone (desde arriba). Los grupos y los nombres de las imágenes se explican en *Grupo de estudio: lista sus imágenes*
GET …/{trim} enumera los grupos que tiene un coche (groups), GET …/{trim}/{group} enumera las imágenes de un grupo (views). Luego se resuelve una aquí. Acepta todas las opciones de imagen, incluidas las opciones de complemento (lights, background, color hex color, windows, plate, fit, size, hotspots).
Ejemplo: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, luego GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp.
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. |
group requerido | cadena | Grupo de estudio: hero, dirigido, extra, drone (ver `groups` en el endpoint de trim). |
image requerido | cadena | Imagen del grupo (ver `views` del grupo). |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
format | cadena | Formato de entrega. pngwebpjpegavifauto |
ratio | cadena | Relación de aspecto. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | integer | Ancho en px. |
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`). |
shadow | cadena | Sombra de estudio en el suelo. truefalse |
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 |
background | cadena | **API v2 complemento:** `white` (predeterminado), `transparent`, o un color hexadecimal de 6 dígitos como `f4f4f4`. Solo imágenes de estudio (lifestyle → errornote `B32`). |
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`. |
fit | cadena | **API v2 complemento:** cómo el coche llena una caja `ratio` / `size` — `contain` rellena (predeterminado), `cover` recorta. Las imágenes lifestyle siempre cubren. containcover |
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 |
