Complemento de API v2
Imagen de grupo de estudio por id
OBTENER/api/id/{id}/{group}/{image}
Complemento de API v2 — claves con acceso a v2. Igual que *Resolver una imagen de grupo de estudio*, pero dirigido por el id estable del auto en lugar de sus nombres. GET /api/id/{id}/{group} lista las imágenes de un grupo. Los autos que solo existen en el complemento tienen ids a partir de 900000000.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
id requerido | integer | Id de configuración estable. |
group requerido | cadena | Grupo de estudio: hero, dirigido, extra, drone. |
image requerido | cadena | Imagen del grupo. |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
format | cadena | Formato de entrega. pngwebpjpegavifauto |
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 |
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 |
