Использование поверхности /api/v1
Создавайте собственную витрину поверх read API платформы.
Что это
Эндпойнты /api/v1 — это JSON-API на чтение для вашего опубликованного инвентаря и контента. Используйте их, чтобы питать собственный фронтенд (Next.js, Astro, Nuxt), нативное приложение, киоск в шоуруме или что угодно ещё, чему нужны ваши данные.
Эта страница адресована тому, кто собирает такого потребителя — обычно разработчику. Если вам просто нужно управлять автомобилями и контентом, встроенная админ-панель уже это делает.
Аутентификация
Отправляйте Authorization: Bearer <your_key> в каждом запросе. Серверные ключи работают откуда угодно. Публикуемым ключам дополнительно нужен заголовок Origin, совпадающий со списком, который вы задали при создании ключа.
curl -H "Authorization: Bearer dlrb_sk_..." \
https://api.dealerbloom.com/api/v1/cars?make=BMW,Audi&pageSize=24
Эндпойнты
GET /api/v1/cars— страничный инвентарь с фильтрами.GET /api/v1/cars/{slug}— полная детализация, включая изображения, характеристики и салон.GET /api/v1/makes— марки и их модели.GET /api/v1/specs— группы характеристик и их значения.GET /api/v1/locations— шоурумы с координатами.GET /api/v1/contact— телефоны, WhatsApp, e-mail, соцсети, часы работы.GET /api/v1/testimonials— опубликованные отзывы.GET /api/v1/team— опубликованные сотрудники.GET /api/v1/content/{pageKey}— контент конкретной страницы.GET /api/v1/settings— название сайта, логотип, валюта.
Фильтрация автомобилей
Мульти-значные фильтры (make, model, color, spec_<slug>) принимают либо значения через запятую, либо повторяющиеся ключи. Значения в пределах одного фильтра совпадают, если применимо ЛЮБОЕ; значения из разных фильтров должны применяться ВСЕ.
?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)
Кросс-доменные запросы
Preflight-запросы браузера (OPTIONS) всегда проходят. Реальный GET проверяет bearer-токен; публикуемые ключи дополнительно должны совпадать с одним из origin, указанных при создании ключа.