Add-on API v2
Rotation 360° : tous les cadres d'un anneau
GET/api/{brand}/{model}/{year}/{variant}/{trim}/360/{ring}
Add-on API v2 — clés avec accès v2. Chaque cadre d'un anneau dans l'ordre, chacun avec son propre image_url signé et son angle — un visualiseur de rotation en a besoin. Les options d'image (format, largeur, couleur, arrière-plan …) s'appliquent à chaque cadre, donc une rotation est toujours cohérente.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
brand obligatoire | chaîne | Nom de la marque (nomenclature du catalogue mise à jour pour les voitures supplémentaires). |
model obligatoire | chaîne | Nom du modèle. |
year obligatoire | entier | Année du modèle (4 chiffres). Si l'année exacte est manquante, la génération disponible la plus proche est utilisée (note d'erreur `Y01`). |
variant obligatoire | chaîne | Variante de carrosserie. |
trim obligatoire | chaîne | Niveau de finition |
ring obligatoire | chaîne | Ring: eye_level, bas ou haut (voir *Rotation à 360°: rings*). |
Paramètres de requête.
| Nom | Type | Description |
|---|---|---|
format | chaîne | Format de livraison. pngwebpjpegavifauto |
width | entier | Largeur en px. |
color | chaîne | Peinture: nom de couleur du catalogue, hexadécimal à 6 chiffres ou `<finish>_<hex>` (par exemple `metallic_315fbf`). |
color_id | entier | Couleur de la peinture par son identifiant à partir de `/api/colors`. Utilisez-le lorsqu'un nom existe plus d'une fois: l'identifiant est unique et ne change jamais. Prend la priorité sur `color`; `0` est la peinture d'origine. Identifiant inconnu ou inactif → même chose qu'un nom inconnu (peinture par défaut + note d'erreur `F04`). |
lights | chaîne | **Add-on de l'API v2 :** phares allumés ou éteints. **Par défaut `on` :** sans le paramètre, l'image arrive avec les phares allumés là où l'image les possède ; envoyez `lights=off` pour une image sans phares. Une image sans variante éclairée arrive simplement sans phares ; avec `lights=on` elle porte également la note d'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 sur l'image (par défaut), `blank` = plaque vide, `logo` = votre logo sur la plaque (à configurer sur votre clé; manquant → vide + note d'erreur `N30`), `text` = votre propre texte à partir de `plate_text` (doit être activé pour votre clé, voir `addon.plate_text` dans `/api/me`; sinon note d'erreur `O31`). noneblanklogotext |
plate_text | chaîne | **Add-on API v2 :** le texte pour `plate=text` — jusqu'à 10 caractères: lettres, chiffres, espaces et `-` `.` `&`. Écrit sur la plaque comme envoyé (majuscules et minuscules conservées), centré et aussi grand que la plaque le permet. Manquant, trop long ou autres caractères → `400`. |
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 |
version | chaîne | Résultats d'une seule version: `v1` = images standard, `v2` = add-on API v2 (pas de retour aux images standard). Sans cela: tout ce que votre clé permet. Non autorisé pour votre clé → `403`. v1v2 |
