Utiliser la surface /api/v1
Construisez une vitrine sur mesure au-dessus de l'API de lecture de la plateforme.
De quoi il s'agit
Les points de terminaison /api/v1 forment une API JSON en lecture pour votre inventaire et vos contenus publiés. Utilisez-les pour alimenter un front personnalisé (Next.js, Astro, Nuxt), une application native, une borne de showroom ou tout autre consommateur de vos données.
Cette page s'adresse à celle ou celui qui construit ce consommateur — souvent un développeur. Si vous voulez simplement gérer véhicules et contenus, l'administration intégrée le fait déjà.
Authentification
Envoyez Authorization: Bearer <votre_cle> à chaque requête. Les clés serveur fonctionnent depuis n'importe où. Les clés publiables nécessitent aussi un en-tête Origin correspondant à la liste que vous avez définie à la création de la clé.
curl -H "Authorization: Bearer dlrb_sk_..." \
https://api.dealerbloom.com/api/v1/cars?make=BMW,Audi&pageSize=24
Points de terminaison
GET /api/v1/cars— parc paginé avec filtres.GET /api/v1/cars/{slug}— fiche complète avec images, caractéristiques et point de vente.GET /api/v1/makes— marques et leurs modèles.GET /api/v1/specs— groupes de caractéristiques et leurs valeurs.GET /api/v1/locations— showrooms avec coordonnées GPS.GET /api/v1/contact— téléphones, WhatsApp, e-mail, réseaux sociaux, horaires.GET /api/v1/testimonials— témoignages publiés.GET /api/v1/team— membres de l'équipe publiés.GET /api/v1/content/{pageKey}— contenu d'une page précise.GET /api/v1/settings— nom du site, logo, devise.
Filtrer les véhicules
Les filtres à valeurs multiples (make, model, color, spec_<slug>) acceptent soit des valeurs séparées par des virgules, soit des clés de requête répétées. À l'intérieur d'un même filtre, les valeurs correspondent si N'IMPORTE laquelle s'applique ; entre filtres différents, TOUTES doivent s'appliquer.
?make=BMW,Audi&model=A4,A6&color=black,white
?spec_body-type=SUV,Coupe&spec_fuel=Hybrid
# (BMW OU Audi) ET (A4 OU A6) ET (noir OU blanc)
# ET (SUV OU Coupé) ET (Hybride)
Requêtes cross-origin
Le préflight du navigateur (OPTIONS) passe toujours. Le vrai GET vérifie le jeton bearer ; les clés publiables doivent aussi correspondre à l'une des origines listées à la création de la clé.