Add-on API v2
Rotation 360° par id
GET/api/id/{id}/360/{ring}
Add-on API v2 — clés avec accès v2. Identique à *360° spin: toutes les images d'un cercle*, adressé par l'identifiant stable du véhicule. GET /api/id/{id}/360 liste les cercles.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
id obligatoire | entier | Identifiant de configuration stable. |
ring obligatoire | chaîne | Ring: eye_level, bas ou haut. |
Paramètres de requête.
| Nom | Type | Description |
|---|---|---|
format | chaîne | Format de livraison. pngwebpjpegavifauto |
width | entier | Largeur en px. |
lights | chaîne | **Add-on API v2 :** phares allumés ou éteints (par défaut `off`). Non disponible pour une image → `off` + erreur `L26`. onoff |
background | chaîne | **Add-on API v2 :** `white` (par défaut), `transparent`, ou une couleur hexadécimale à 6 chiffres comme `f4f4f4`. Images studio uniquement (lifestyle → erreur `B32`). |
windows | chaîne | **Add-on API v2 :** `see_through` = vitrage comme dans l'image (par défaut), `dark` = vitrage teinté opaque. Non disponible → erreur `W28`. see_throughdark |
plate | chaîne | **Add-on API v2 :** plaque d'immatriculation — `none` = comme dans l'image (par défaut), `blank` = plaque vide, `logo` = votre logo sur la plaque (à configurer sur votre clé; manquant → blanc + erreur `N30`). noneblanklogo |
fit | chaîne | **Add-on API v2 :** comment la voiture remplit une boîte `ratio` / `size` — `contain` rembourre (par défaut), `cover` recadre. Les images lifestyle couvrent toujours. containcover |
size | chaîne | **Add-on API v2 :** côté le plus long — `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` prennent le pas sur `size`. 2k1080p720p540p360pthumb |
