Bild
Eine signierte Bild-URL auflösen
Holen/api/{brand}/{model}/{year}/{variant}/{trim}/{view}
Der Kern-Endpunkt. Gibt Metadaten plus eine signierte image_url zurück, die Sie direkt in ein <img> einbetten.
Jede Option als Abfrageparameter hinzufügen. Alles, was für das Auto nicht verfügbar ist oder nicht durch Ihren Plan erlaubt ist, fällt auf den nächstgelegenen gültigen Wert zurück und wird in errornotes gemeldet (anstatt zu scheitern).
Beispiele
?format=webp&width=1200— WebP, 1200 Pixel breit.?ratio=16:9&format=jpeg— auf 16:9 aufgefüllt.?mirroring=true— Auto auf einem spiegelnden Showroom-Boden.?transparency=true&format=png— Ausschnitt auf transparentem Hintergrund.?color=wine_red— in der Hausfarbe wine_red lackiert.?color=Racing%20Red&shadow=true— Kia Katalogfarbe plus Studio-Schatten.
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
brand erforderlich | Zeichenkette | Markenname oder Alias (groß- und kleinschreibungsunabhängig). |
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. |
view erforderlich | Zeichenkette | Ansicht Name - siehe /api/views (z.B. front, front_left, rear). |
Abfrageparameter.
| Name | Typ | Beschreibung |
|---|---|---|
format | Zeichenkette | Lieferformat. `auto` wählt WebP. Original ist PNG. pngwebpjpegavifauto |
resolution | Zeichenkette | Größen-/Qualitätsvorgabe (wird durch explizite Breite/Qualität überschrieben). defaultthumbsmallmediumlargefull |
ratio | Zeichenkette | Auf ein Seitenverhältnis auffüllen. `default` = nativ. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | Ganzzahl | Explizite Breite in px (auf die Breitenleiter geschnappt). |
height | Ganzzahl | Explizite Höhe in px. |
quality | Ganzzahl | Encoder-Qualität (40–100). |
color | Zeichenkette | Lackfarbe nach Name (Groß- und Kleinschreibung wird ignoriert; Leerzeichen im URL-Format kodieren, z.B. `Racing%20Red`). Das Auto wird auf Anfrage neu lackiert - Finish-true, Reflexionen und Zierleisten erhalten. Die `/colors` eines Autos listen den gezeigten Satz auf (Hausfarben + die Farben seiner Marke); Jede aktive Farbe aus `/api/colors` kann angefordert werden. Unbekannte Farbe → Standardlack + Fehlermeldung `F04`. Kombiniert mit jeder anderen Option. |
shadow | Zeichenkette | Studio-Bodenschatten - zum Lieferzeitpunkt gerendert, für jede Außenansicht verfügbar. Mit `mirroring=true` steuert dies den Unterbodenschatten. truefalse |
transparency | Zeichenkette | Transparenter Hintergrund mit Ausschnitt - verfügbar für jede Außenansicht (verwenden Sie mit PNG/WebP). truefalse |
ground | Zeichenkette | Setzen Sie das Auto auf den Boden (benötigt eine transparente Variante). true |
mirroring | Zeichenkette | Reflektierender Boden. `true` = mit Unterboden-Schatten, `clean` = nur Reflexion. Benötigt eine transparente Variante. trueclean |
