Bookvero

Получение слотов (GET /api/partners/v1/slots)

Параметры запроса, ограничения и формат ответа по коду handler.

Обновлено:

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

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

Получение слотов

Запрос

GET /api/partners/v1/slots

Query-параметры (обязательные):

  • workspaceSlug — slug пространства
  • serviceId — id услуги

Ровно один из:

  • resourceId — id ресурса
  • roomId — id зала

Передать оба resourceId и roomId нельзя — вернётся 400.

Условия на стороне сервера

  • Услуга должна существовать, быть ACTIVE и с publicBooking: true для этого пространства.
  • Пространство должно быть в статусе TRIAL или ACTIVE (иначе 403 с пояснением).
  • Ключ должен иметь scope slots.read и доступ к workspace (403, если slug чужой).

Ответ

JSON с полями вроде:

  • slots — массив объектов с startAt, endAt, serviceId, опционально resourceId или roomId (ISO-8601 в строках)
  • targetTyperoom или resource
  • targetId — id выбранной цели

Лимит: на ответ может накладываться усечение списка (в коде возвращается срез слотов, например до 30 записей — сверяйте с актуальной версией handler).

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

На IP действует rate limit: PARTNER_API_SLOTS_GET_PER_MINUTE (значение в коде — сейчас 120 запросов в минуту). При превышении — 429 и заголовки с данными о лимите.

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

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