Catalogue

Tout par identifiant stable

GET/api/id/{id}

Résolvez une configuration par son identifiant stable (retourné par chaque point de terminaison du catalogue; ne change jamais). Retourne une entrée par vue disponible — chacune identique à la réponse d'image à vue unique, y compris l'image_url signée. Toutes les options d'image (format, color, shadow, width, …) s'appliquent à chaque vue.

Add-on de l'API v2: fonctionne de la même manière pour les voitures supplémentaires (ids à partir de 900000000), et leurs groupes sont également accessibles par id. Consultez *Image de groupe Studio par id*, *Rotation 360° par id* et *Image de style de vie par id*.

Paramètres de chemin

Nom	Type	Description
`id` obligatoire	entier	Identifiant de configuration stable.

Demande

curl "https://api.vehicleimagery.com/api/id/id" \
  -H "x-api-key: YOUR_API_KEY"

200 · Une entrée par vue.

[
  {
    "id": 671025573,
    "brand": "BMW",
    "model": "2",
    "year": 2021,
    "variant": "Basis",
    "trim": "base",
    "view": "front",
    "resolution": "default",
    "ratio": "default",
    "format": "png",
    "image_url": "https://cdn.vehicleimagery.com/…"
  }
]

401 · Clé `x-api-key` manquante ou invalide.

{
  "error": "Invalid API key"
}

403 · Restriction de plan (fonctionnalité, format ou marque non autorisés) ou demande bloquée.

{
  "error": "Mirroring is not allowed by your plan."
}

404 · Aucune donnée pour le chemin demandé.

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}