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.

Les couleurs appartiennent à la marque: si cette configuration exacte n'est pas dans le catalogue (par exemple une finition inconnue), les couleurs de la marque sont renvoyées quand même, avec id: null et vehicle_found: false. Seule une marque inconnue répond 404.

API v2 add-on: pour une voiture avec des images d'options supplémentaires, la réponse inclut également any_hex_color: true. Sa peinture peut également être définie sur n'importe quelle couleur hexadécimale à 6 chiffres, par exemple, ?color=c8102e.

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

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`

Demande

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/colors?version=v1" \
  -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."
}