Katalog

Farben für eine Konfiguration

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

Für dieses Auto gezeigte Farben, bewusst kompakt gehalten: die Hausfarben von Vehicle Imagery (auf jedem Auto verfügbar) plus die Farben der eigenen Marke dieses Autos. Jede aktive Katalogfarbe kann auf jedem Auto angefordert werden. Geben Sie einen Namen als ?color= am Bild-Endpunkt an. Der vollständige Katalog mit Markenpaarung befindet sich unter /api/colors; siehe auch die Anleitung *Lackfarben* unter /info/guides/colors.

API v2 Zusatz: für ein Auto mit Zusatzbildern enthält die Antwort auch any_hex_color: true — seine Farbe kann zusätzlich auf jede 6-stellige Hex-Farbe eingestellt werden, z.B. ?color=c8102e

Pfadparameter

Name	Typ	Beschreibung
`brand` erforderlich	Zeichenkette	Markenname oder Alias (groß- und kleinschreibungsunabhängig).
`model` erforderlich	Zeichenkette	Modellname.
`year` erforderlich	Ganzzahl	Modelljahr (4-stellig). Wenn das genaue Jahr fehlt, wird die nächste verfügbare Generation verwendet (Fehlermeldung `Y01`).
`variant` erforderlich	Zeichenkette	Karosserie-Variante.
`trim` erforderlich	Zeichenkette	Ausstattungsvarianten.

Anfragen

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

200 · Farben.

[
  {
    "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 · Fehlender oder ungültiger `x-api-key`.

{
  "error": "Invalid API key"
}

403 · Planbeschränkung (Funktion, Format oder Marke nicht erlaubt) oder blockierter Anfrage.

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

404 · Keine Daten für den angeforderten Pfad.

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