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: Katalogfarbname oder 6-stellige Hex. |
lights | Zeichenkette | **API v2 add-on:** Scheinwerfer an oder aus (Standard `off`). Nicht verfügbar für ein Bild → `off` + 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 + Fehlerhinweis `N30`). noneblanklogo |
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 |
