Обзор партнёрского API
Базовый URL, версия v1 и два основных endpoint для интеграций.
Обновлено:
Источник в репозитории
- apps/app/src/app/api/partners/v1/slots/route.ts
- apps/app/src/app/api/partners/v1/bookings/route.ts
Обзор партнёрского API
Кратко: публичный партнёрский API Bookvero версии v1 предоставляет чтение слотов и создание бронирований для одного пространства в соответствии с правами ключа.
Базовый URL
В продакшене интеграции обычно вызывают отдельный хост https://api.bookvero.ru с путём /api/partners/v1/... (см. инфраструктурную документацию деплоя). Точное значение базового URL может задаваться переменной окружения BOOKVERO_PARTNER_API_PUBLIC_BASE на стороне клиента интеграции.
Endpoints
| Метод | Путь | Назначение |
|---|---|---|
GET | /api/partners/v1/slots | Список доступных слотов |
POST | /api/partners/v1/bookings | Создание бронирования |
Аутентификация
Все запросы — с заголовком Authorization: Bearer <token>. Подробнее — Авторизация и ключи.
Scopes
У ключа может быть одно или оба права: slots.read, bookings.write — см. код partnerApiScopes в репозитории.
Не нашли ответ?
Напишите в поддержку Bookvero через контакты — подскажем по продукту. По правилам конкретного заведения (отмена, деньги) лучше обращаться напрямую в это заведение.