Katalog

Bulk-Dump aller Konfigurationen

Holen/api/getall

Jede für Ihren Schlüssel verfügbare Konfiguration in einer Antwort — ein Eintrag pro Auto (Marke/Modell/Jahr/Variante/Ausstattung). Farben werden hier nicht erweitert. Jeder Eintrag enthält einen colors_available Boolean (true = das Auto kann über ?color= umlackiert werden, false = nur die Originallackierung). Die konkreten Farbnamen finden Sie im /colors (oder /all) Endpunkt des Autos. Zusätzlich enthält jeder Eintrag years — der Suchjahresbereich, für den dieser Eintrag verwendet werden sollte: { from, to, source } wobei source successor (hartes Ende, eine neuere Version existiert), estimated (kein Nachfolger im Katalog — Ende geschätzt) oder open (to: null, neueste Generation) ist — plus next_model_year. Innerhalb eines Modells + einer Variante + einer Ausstattung überlappen sich diese Bereiche nie: Ein bestimmtes Jahr passt zu maximal einem Eintrag pro Zeile. (Derzeit wird es zuerst auf dem Dev-Host ausgerollt.) Plan-geschützt. Verwenden Sie es für eine einmalige Synchronisation anstelle von pro Anfrage.

Anfragen

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

200 · Alle Konfigurationen.

[
  {
    "id": 911,
    "path": "Abarth/124_Spider_Abarth/2016/Basis/base",
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "variant": "Basis",
    "trim": "base",
    "year": 2016,
    "views": [
      "front",
      "front_left",
      "rear",
      "right"
    ],
    "colors_available": true,
    "years": {
      "from": 2016,
      "to": null,
      "source": "open"
    },
    "next_model_year": null
  }
]

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