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.

Die Farben gehören zur Marke: wenn diese genaue Konfiguration nicht im Katalog vorhanden ist (beispielsweise ein unbekanntes Modell), werden die Farben der Marke trotzdem zurückgegeben, mit id: null und vehicle_found: false. Nur eine unbekannte Marke gibt 404 zurück.

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.

Abfrageparameter.

Name	Typ	Beschreibung
`version`	Zeichenkette	Ergebnisse nur von einer Version: `v1` = Standardbilder, `v2` = API v2 Zusatz (kein Rückfall auf Standardbilder). Ohne diesen Parameter: alles, was Ihr Schlüssel erlaubt. Nicht erlaubt für Ihren Schlüssel → `403`. `v1v2`

Anfragen

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