Referenz

Alle Farbnamen

Holen/api/colors

Jede aktive Katalogfarbe als color_name + color_make-Paar, plan-gefiltert. Vehicleimagery-Farben (Hausfarben) erscheinen in jedem Auto unter /colors; Markenfarben nur für Autos dieser Marke. Die Sichtbarkeit pro Auto ist im Konfigurations-Endpunkt /colors enthalten.

Anfragen

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

200 · Farben.

{
  "colors": [
    {
      "color_name": "default",
      "color_make": "Vehicleimagery"
    },
    {
      "color_name": "Bell Flower",
      "color_make": "Hyundai"
    },
    {
      "color_name": "wine_red",
      "color_make": "Vehicleimagery"
    }
  ]
}

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