Получение слотов (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 в строках)targetType—roomилиresourcetargetId— id выбранной цели
Лимит: на ответ может накладываться усечение списка (в коде возвращается срез слотов, например до 30 записей — сверяйте с актуальной версией handler).
Лимит запросов
На IP действует rate limit: PARTNER_API_SLOTS_GET_PER_MINUTE (значение в коде — сейчас 120 запросов в минуту). При превышении — 429 и заголовки с данными о лимите.
См. также
Не нашли ответ?
Напишите в поддержку Bookvero через контакты — подскажем по продукту. По правилам конкретного заведения (отмена, деньги) лучше обращаться напрямую в это заведение.