Die /api/v1-Oberfläche nutzen
Bauen Sie eine eigene Verkaufsseite auf der Read-API der Plattform auf.
Was es ist
Die /api/v1-Endpunkte sind eine JSON-Read-API für Ihren veröffentlichten Bestand und Ihre Inhalte. Nutzen Sie sie, um ein eigenes Frontend (Next.js, Astro, Nuxt), eine native App, einen Showroom-Kiosk oder alles andere zu betreiben, das Ihre Daten benötigt.
Diese Seite richtet sich an denjenigen, der diesen Konsumenten baut — üblicherweise einen Entwickler. Wenn Sie einfach nur Fahrzeuge und Inhalte verwalten möchten, erledigt das die eingebaute Admin-Oberfläche bereits.
Authentifizierung
Senden Sie bei jeder Anfrage Authorization: Bearer <ihr_schlüssel>. Server-Schlüssel funktionieren von überall. Publishable-Schlüssel benötigen zusätzlich einen Origin-Header, der zur Liste passt, die Sie beim Erstellen des Schlüssels festgelegt haben.
curl -H "Authorization: Bearer dlrb_sk_..." \
https://api.dealerbloom.com/api/v1/cars?make=BMW,Audi&pageSize=24
Endpunkte
GET /api/v1/cars— paginierter Bestand mit Filtern.GET /api/v1/cars/{slug}— vollständige Details inklusive Bilder, Ausstattung und Standort.GET /api/v1/makes— Marken und ihre Modelle.GET /api/v1/specs— Ausstattungsgruppen und ihre Werte.GET /api/v1/locations— Showrooms mit Kartenkoordinaten.GET /api/v1/contact— Telefonnummern, WhatsApp, E-Mail, Social-Handles, Öffnungszeiten.GET /api/v1/testimonials— veröffentlichte Testimonials.GET /api/v1/team— veröffentlichte Team-Mitglieder.GET /api/v1/content/{pageKey}— Inhalt einer bestimmten Seite.GET /api/v1/settings— Websitename, Logo, Währung.
Fahrzeuge filtern
Mehrwertige Filter (make, model, color, spec_<slug>) akzeptieren entweder kommagetrennte Werte oder wiederholte Query-Parameter. Werte innerhalb eines Filters treffen zu, wenn IRGENDEINER passt; Werte über verschiedene Filter hinweg müssen ALLE passen.
?make=BMW,Audi&model=A4,A6&color=black,white
?spec_body-type=SUV,Coupe&spec_fuel=Hybrid
# (BMW OR Audi) AND (A4 OR A6) AND (black OR white)
# AND (SUV OR Coupe) AND (Hybrid)
Cross-Origin-Anfragen
Der Browser-Preflight (OPTIONS) läuft immer durch. Das eigentliche GET prüft das Bearer-Token; Publishable-Schlüssel müssen zusätzlich zu einem der beim Erstellen hinterlegten Origins passen.