Catalogue

Couleurs pour une configuration

GET/api/{brand}/{model}/{year}/{variant}/{trim}/colors

Couleurs affichées pour cette voiture, volontairement compactes: les couleurs maison de Vehicleimagery (disponibles sur chaque voiture) plus les couleurs de la marque de cette voiture. Toute couleur de catalogue active peut encore être demandée sur toute voiture. Passez un nom en tant que ?color= sur le point de terminaison de l'image. Le catalogue complet avec les associations de marques se trouve à /api/colors; voir aussi le guide *Couleurs de peinture* à /info/guides/colors.

Paramètres de chemin

Nom	Type	Description
`brand` obligatoire	chaîne	Nom de marque ou alias (insensible à la casse).
`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

Demande

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/colors" \
  -H "x-api-key: YOUR_API_KEY"

200 · Couleurs.

[
  {
    "id": 911,
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "year": 2016,
    "variant": "Basis",
    "trim": "base",
    "resolution": "default",
    "format": "png",
    "colors": [
      "default",
      "black",
      "white",
      "blue",
      "orange",
      "wine_red"
    ]
  }
]

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."
}