Bild

Ein Bild pro Modell

Holen/api/{brand}/{model}/image

Ein repräsentatives Bild eines Modells ohne Kenntnis des Jahres, Karosserietyps oder der Ausstattung, z.B. für einen Modellauswähler. /api/{brand}/{model}/modelimage ist der gleiche Endpunkt.

Das Auto wird nach einer festen Regel ausgewählt, sodass dasselbe Modell immer dasselbe Auto zurückgibt: das neueste Jahr, der häufigste Karosserietyp dieses Jahres, die Basisausstattung (andernfalls die erste) und die Ansicht front_left (andernfalls die erste Außenansicht, die Ihr Plan erlaubt). Sie können es mit year, variant oder view eingrenzen.

Die Antwort ist genau die Antwort für ein Einzelbild des ausgewählten Autos. id, year, variant und trim zeigen Ihnen, welches es ist. So können Sie mit dem Katalog oder /api/id/{id} fortfahren. Alle Bildoptionen (format, width, color, …) gelten, und es wird wie jedes einzelne Bild gezählt.

Pfadparameter

NameTypBeschreibung
brand erforderlich Zeichenkette Markenname — siehe /api/brands.
model erforderlich Zeichenkette Modellname — siehe /api/{brand}.

Abfrageparameter.

NameTypBeschreibung
year Ganzzahl Verwenden Sie die Erzeugung dieses Jahres anstelle des neuesten (gleiche Regel wie der Katalog).
variant Zeichenkette Nur dieser Karosserietyp (äquivalente Namen wie `Kombi` / `Estate` funktionieren wie im Katalog).
view Zeichenkette Eine andere Ansicht als `front_left` — siehe /api/views.
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