workplaces.reservation.add

Scope: workplaces

Кто может вызывать: Право брони на место; за другого — T на элемент или админ офиса

Проверка конфликтов и лимитов типа места. Типы: hourly, workDay, tolkRoom.

HTTP: POST

Побочные эффекты: Уведомления; при USE_CONFIRM=Y — ожидание подтверждения

Параметры метода

Параметр Тип Обяз. Описание
workplaceId int да
dateFrom string да Начало
dateTo string да Конец
userId int нет По умолчанию текущий
reservationType string нет hourly
active bool нет По умолчанию true

Возвращаемые данные

result.result: { "id": 10 }

Обработка ошибок

Ответ в едином конверте модуля: result, total, next, error (внутри обёртки Bitrix REST — поле result). Справочник всех кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
INTERNAL_ERROR Внутренняя ошибка
ACCESS_DENIED Бронирование отключено или нет прав на место
VALIDATION_ERROR Пустые даты; место закреплено; некорректные поля
WORKPLACE_NOT_FOUND Рабочее место не найдено
USER_NOT_FOUND Пользователь (linkedUserId) не найден
RESERVATION_CONFLICT details.conflicting_reservation_id
LIMIT_EXCEEDED Превышен лимит бронирований
INVALID_DATE_RANGE Некорректный dateFrom / dateTo

Примеры кода

Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/workplaces.reservation.add.json" \
          -H "Content-Type: application/json" \
          -H "Accept: application/json" \
          -d '{"workplaceId": 1234, "dateFrom": "2026-06-10 09:00:00", "dateTo": "2026-06-10 18:00:00"}'

Пример ответа

{
          "result": {
            "result": {
              "id": 10
            },
            "next": null,
            "error": null
          },
          "total": 0
        }
Предыдущая
workplaces.reservation.get
Следующая
workplaces.reservation.update