API v2 Add-on: Studio-Sets, 360°-Rundgänge und Lifestyle-Szenen
Neu mit dem API v2 Add-on: Studio-Gruppen, volle 360°-Drehungen und Lifestyle-Szenen — dieselben Schlüssel, dieselben Aufrufe, plus neue Bildoptionen. Und eine schnellere, fairere Warteschlange für neue Bilder.
28. September 202613 Änderungen
Hinzugefügt
API v2 Add-on für Schlüssel mit v2-Zugriff (access in /api/me: v2 oder all). Fahrzeuge mit Add-on-Bildern listen groups auf der Trim-Endpunkt neben views auf.
Studio-Gruppen hero, gelenkt, extra und Drohne: …/{trim}/{group} listet die Bilder auf, …/{trim}/{group}/{image} löst eines auf.
360°-Drehungen in drei Ringen (eye_level, low, high): …/{trim}/360 listet sie auf, …/{trim}/360/{ring} gibt jeden Frame mit seiner eigenen signierten image_url zurück.
Lifestyle-Szenen: …/{trim}/lifestyle, …/lifestyle/{scene} und …/lifestyle/{scene}/{image}
Add-on-Bildoptionen: lights=on, background (weiß, transparent oder hex), Lack color als hex (z.B. c8102e), windows=dark, plate=blank|logo, fit=contain|cover, size (2k … thumb) und hotspots=true (Interessenspunkte für interaktive Betrachter).
Neue Fehlerhinweise für das Add-on: G23, M24, L26, W28, N29, N30, O31, B32 — alle aufgeführt in /api/errornotes.
/api/me zeigt nun access (v1, v2, all) und queue_priority an; mit dem Add-on auch einen addon Abschnitt (Formate, Gruppen, Optionen, Marken, Kennzeichenlogo).
Mit dem Add-on findet /api/search Add-on-Fahrzeuge, /api/getall listet sie mit ihren groups auf, und ein Fahrzeugs /colors, /features und /all beschreiben seine Add-on-Optionen (any_hex_color, features.addon).
/api/options, /api/sizes und /api/views fügen einen addon Abschnitt hinzu: die Add-on Optionen mit ihren Werten, die size Voreinstellungen und die Gruppen.
Alles funktioniert auch über eine stabile ID: /api/id/{id}/{group}/{image}, /api/id/{id}/360/{ring}, /api/id/{id}/lifestyle/{scene}/{image}
Verbessert
Neue Bilder werden in einer fairen Warteschlange erstellt: Pläne mit höherer Priorität gehen zuerst, und identische Anfragen, die zur gleichen Zeit eintreffen, werden nur einmal erstellt.
Das Neu lackieren vieler Farben desselben Bildes auf einmal erstellt seine Lackmaske nur einmal statt für jede Farbe. Die ersten Ladevorgänge unter Last sind viel schneller und zuverlässiger.
Unter sehr hoher Last antwortet eine Bild-URL jetzt mit 503 busy und Retry-After anstelle des Zeitablaufs. Antworten enthalten X-Cache und X-Queue-Wait-Ms
Möchten Sie diese Bilder für Ihren Bestand?
Teilen Sie uns mit, welche Fahrzeuge Sie auflisten und wir senden Ihnen echte Beispiele aus Ihrem eigenen Bestand zurück.