Complemento de API v2
Giro 360° por id
OBTENER/api/id/{id}/360/{ring}
Complemento de API v2 — claves con acceso v2. Igual que *360° spin: todos los fotogramas de un anillo*, dirigido por el id estable del coche. GET /api/id/{id}/360 lista los anillos.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
id requerido | integer | Id de configuración estable. |
ring requerido | cadena | Ring: eye_level, bajo o alto. |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
format | cadena | Formato de entrega. pngwebpjpegavifauto |
width | integer | Ancho en px. |
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 |
