Complemento de API v2
Resolver una imagen de grupo de estudio
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 o hexadecimal de 6 dígitos. |
shadow | cadena | Sombra de estudio en el suelo. truefalse |
lights | cadena | **API v2 complemento:** faros encendidos o apagados (predeterminado `off`). No disponible para una imagen → `off` + errornote `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 matrícula — `none` = como en la imagen (predeterminado), `blank` = placa vacía, `logo` = su logo en la placa (configurado en su clave; faltante → en blanco + errornote `N30`). noneblanklogo |
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 |
