Обзор партнёрского API

Кратко: публичный партнёрский API Bookvero версии v1 — 12 HTTP endpoints для слотов, броней, каталога, клиентов, платежей и исходящих webhooks. Доступен на тарифе Platform (GROWTH+) с scoped API keys.

Базовый URL

В продакшене интеграции обычно вызывают https://app.bookvero.ru с путём /api/partners/v1/.... Точное значение может задаваться BOOKVERO_PARTNER_API_PUBLIC_BASE на стороне клиента.

Endpoints (12/12)

#	Метод	Путь	Scope	Назначение
1	GET	/api/partners/v1/slots	slots.read	Доступные слоты
2	POST	/api/partners/v1/bookings	bookings.write	Создание брони
3	GET	/api/partners/v1/bookings	bookings.read	Список броней
4	GET	/api/partners/v1/bookings/{id}	bookings.read	Детали брони
5	PATCH	/api/partners/v1/bookings/{id}	bookings.write	Отмена / перенос
6	GET	/api/partners/v1/services	catalog.read	Каталог услуг
7	GET	/api/partners/v1/rooms	catalog.read	Залы / ресурсы
8	GET	/api/partners/v1/clients	clients.read	Список клиентов
9	GET	/api/partners/v1/clients/{id}	clients.read	Карточка клиента
10	GET	/api/partners/v1/payments	payments.read	Журнал платежей
11	POST	/api/partners/v1/webhooks/test	bookings.read или bookings.write	Тест исходящего webhook
12	GET	/api/partners/v1/webhooks/deliveries	webhooks.read	Журнал доставок webhook

Полная спецификация: OpenAPI в репозитории (apps/app/public/partner-api-openapi.yaml) и docs/partner-api.md.

Аутентификация

Все запросы — с заголовком Authorization: Bearer <token>. Подробнее — Авторизация и ключи.

Scopes

slots.read, bookings.read, bookings.write, catalog.read, clients.read, payments.read, webhooks.read — см. partnerApiScopes в репозитории и UI «Партнёрский API» в кабинете.