API v2 Add-on
Studio-Gruppenbild nach ID
Holen/api/id/{id}/{group}/{image}
API v2 Add-on — Schlüssel mit v2-Zugriff. Gleich wie *Studio-Gruppenbild auflösen*, aber mit der stabilen ID des Autos anstatt seiner Namen. GET /api/id/{id}/{group} listet die Bilder einer Gruppe auf. Autos, die nur im Add-on existieren, haben IDs ab 900000000.
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
id erforderlich | Ganzzahl | Stabile Konfigurations-ID. |
group erforderlich | Zeichenkette | Studio-Gruppe: Held, gelenkt, extra, Drohne. |
image erforderlich | Zeichenkette | Bild der Gruppe |
Abfrageparameter.
| Name | Typ | Beschreibung |
|---|---|---|
format | Zeichenkette | Auslieferungsformat. pngwebpjpegavifauto |
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 |
background | Zeichenkette | **API v2 add-on:** `white` (Standard), `transparent` oder eine 6-stellige Hex-Farbe wie `f4f4f4`. Nur Studiobilder (Lifestyle → Fehlerhinweis `B32`). |
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`. |
fit | Zeichenkette | **API v2 add-on:** wie das Auto ein `ratio` / `size` Feld füllt — `contain` füllt auf (Standard), `cover` schneidet ab. Lifestyle-Bilder decken immer ab. containcover |
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 |
