Complemento de API v2
Giro de 360°: todos los fotogramas de un anillo
OBTENER/api/{brand}/{model}/{year}/{variant}/{trim}/360/{ring}
API v2 complemento — claves con acceso a v2. Cada fotograma de un anillo en orden, cada uno con su propia image_url firmada y su ángulo — un visor de giro necesita todos ellos. Las opciones de imagen (formato, ancho, color, fondo) se aplican a cada fotograma, así que un giro es siempre consistente.
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. |
ring requerido | cadena | Ring: eye_level, bajo o alto (ver *360° spin: rings*). |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
format | cadena | Formato de entrega. pngwebpjpegavifauto |
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`). |
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 |
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 |
