Add-on API v2
Groupe studio : lister ses images
GET/api/{brand}/{model}/{year}/{variant}/{trim}/hero
Add-on API v2 — clés avec accès v2. Les images d'un groupe de studio. hero désigne tout groupe de studio de la voiture. Les groupes qu'une voiture possède sont dans groups sur l'endpoint trim.
| Groupe | Ce qu'il montre | Noms des images (exemple de voiture) |
|---|---|---|
hero | Photos héroïques : vues en trois quarts, certaines prises au niveau du sol | front_left, front_left_ground, front_right, front_right_ground, left_ground, rear_left, rear_right, right_ground (8) |
steered | Roues avant tournées, vues de trois hauteurs de caméra | front_left, front_left_eye, front_left_high, front_left_low, front_right, … (8) |
extra | Plus d'angles : chaque côté et coin depuis trois hauteurs de caméra, les coins également à 30° et 45° | front_eye, front_high, front_low, front_left_30, front_left_30_eye, front_left_45_high, rear_right_45_low, left_eye … (56) |
drone | Vue du dessus: prises de vue inclinées, vues en plongée et vues de dessus | front_left, front_right, front_steep, rear_left, rear_right, rear_steep, top (7) |
Les noms des images sont construits à partir du côté (front, front_left, left, rear_right …) plus des suffixes: _eye = au niveau des yeux, _high = caméra au-dessus, _low = caméra basse, _ground = au niveau du sol, _30 / _45 = vue en coin à 30° / 45°, _steep = vue en plongée, top = vue de dessus. La liste exacte par voiture se trouve toujours dans views de cet endpoint.
Choisissez une image parmi views et résolvez-la avec *Résoudre une image de groupe studio*, par exemple GET /api/Audi/Q9/2026/SUV/Default/hero/front_left
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 |
Paramètres de requête.
| Nom | Type | Description |
|---|---|---|
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 |
