API v2 Add-on
Lifestyle: Bild auflösen
Holen/api/{brand}/{model}/{year}/{variant}/{trim}/lifestyle/{scene}/{image}
API v2 Add-on — Schlüssel mit v2-Zugang. Ein Lifestyle-Bild mit einer signierten image_url. Lifestyle-Bilder sind vollständige Szenen: sie füllen immer den Rahmen (fit=cover), ein background ist nicht anwendbar (Fehlermeldung B32). Farbe (color), lights, size, ratio und format funktionieren wie überall.
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
brand erforderlich | Zeichenkette | Brand name (aktualisierte Katalogbezeichnung für Add-on-Fahrzeuge). |
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. |
scene erforderlich | Zeichenkette | Szene. |
image erforderlich | Zeichenkette | Bild der Szene (siehe *Lifestyle: Bilder einer Szene*). |
Abfrageparameter.
| Name | Typ | Beschreibung |
|---|---|---|
format | Zeichenkette | Auslieferungsformat. pngwebpjpegavifauto |
ratio | Zeichenkette | Seitenverhältnis (beschnitten, um zu füllen). 1:14:33:216:916:102:121:95:43:44:52:39:16 |
color | Zeichenkette | Lack: Katalogfarbenname, 6-stellige Hex oder `<finish>_<hex>` (z.B. `metallic_315fbf`). |
color_id | Ganzzahl | Farbcode nach ID aus `/api/colors`. Verwenden, wenn ein Name mehrmals existiert: die ID ist einzigartig und ändert sich nie. Hat Vorrang vor `color`; `0` ist die Originalfarbe. Unbekannte oder inaktive ID → wie ein unbekannter Name (Standardfarbe + Fehlermeldung `F04`). |
lights | Zeichenkette | **API v2 Zusatz:** Scheinwerfer ein- oder ausgeschaltet. **Standardmäßig `on`:** ohne den Parameter kommt das Bild mit eingeschalteten Lichtern, wo immer das Bild sie hat; senden Sie `lights=off` für ein Bild ohne Lichter. Ein Bild ohne Lichtvariante kommt einfach ohne Lichter; mit `lights=on` enthält es auch den Fehlerhinweis `L26`. onoff |
windows | Zeichenkette | **API v2 add-on:** `see_through` = Glas wie im Bild (Standard), `dark` = getönte Scheiben, durch die man nicht hindurchsehen kann. Nicht verfügbar → Fehlerhinweis `W28`. see_throughdark |
plate | Zeichenkette | **API v2 add-on:** Kennzeichen — `none` = wie im Bild (Standard), `blank` = leeres Kennzeichen, `logo` = Ihr Logo auf dem Kennzeichen (in Ihrem Schlüssel eingerichtet; fehlt → leer + Fehlernotiz `N30`), `text` = Ihr eigener Text aus `plate_text` (muss für Ihren Schlüssel aktiviert sein, siehe `addon.plate_text` in `/api/me`; andernfalls Fehlernotiz `O31`). noneblanklogotext |
plate_text | Zeichenkette | **API v2 add-on:** der Text für `plate=text` — bis zu 10 Zeichen: Buchstaben, Ziffern, Leerzeichen und `-` `.` `&`. Auf dem Kennzeichen wie gesendet geschrieben (Groß- und Kleinschreibung bleibt erhalten), zentriert und so groß wie das Kennzeichen es zulässt. Fehlt, zu lang oder andere Zeichen → `400`. |
size | Zeichenkette | **API v2 Add-on:** längste Seite `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` übersteigen `size`. 2k1080p720p540p360pthumb |
hotspots | Zeichenkette | **API v2 add-on:** `hotspots` zur Antwort hinzufügen — Interessante Punkte (Felgen, Scheinwerfer …) als Brüche 0–1 des Bildes, z.B. für interaktive Betrachter. true |
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 |
