Bookvero
Меню
Продукт

Для кого

ФотостудииЛофтыРепетиционные базыПрокатыЗалы и площадки
ВозможностиТарифыДемо

Ресурсы

БлогОбновленияДорожная картаAI-помощникMini AppsБезопасностьFAQБаза знанийДокументы
ВойтиРегистрация

Создание бронирования (POST /api/partners/v1/bookings)

Тело JSON, обязательные поля и проверки по коду handler.

Обновлено:

Источник в репозитории

  • apps/app/src/app/api/partners/v1/bookings/route.ts
  • apps/app/src/lib/domains/partners/public-rate-limits.ts

Создание бронирования

Запрос

POST /api/partners/v1/bookings

Тело: JSON с полями (тип в коде PartnerBookingPayload):

Обязательные:

  • workspaceSlug
  • clientName
  • phone
  • serviceId
  • startAt — строка времени (ISO), парсится на сервере
  • ровно одно из: resourceId или roomId

Опциональные:

  • email
  • notes

Если JSON некорректен — 400. Если указаны и resourceId, и roomId — 400 с текстом «Укажите либо resourceId, либо roomId».

Авторизация

Нужен scope bookings.write и доступ к workspace ключа (403 при несовпадении).

Лимит запросов

PARTNER_API_BOOKINGS_POST_PER_MINUTE — сейчас 90 POST на IP в минуту; при превышении — 429.

Идемпотентность

Отдельный заголовок идемпотентности в текущем handler не используется — не рассчитывайте на встроенную дедупликацию повторных POST без проверки кода в будущих версиях.

См. также

Не нашли ответ?

Напишите в поддержку Bookvero через контакты — подскажем по продукту. По правилам конкретного заведения (отмена, деньги) лучше обращаться напрямую в это заведение.