Для AI-агентов: markdown этой страницы — /docs-content/entities/booking-resources/slots-set.md индекс документации — /llms.txt

Задать рабочие часы ресурса

PUT /v1/booking-resources/:id/slots

Записывает рабочие часы ресурса бронирования переданным набором интервалов: прежние интервалы удаляются. Пустой массив slots снимает все рабочие часы.

Параметры

Параметр Тип Обяз. Описание
id (path) number да ID ресурса бронирования. Список: GET /v1/booking-resources

Поля запроса (body)

Поле Тип Обяз. Описание
slots array да Новый набор интервалов рабочих часов. Пустой массив снимает все рабочие часы
slots[].from number да Начало интервала в минутах от полуночи, от 0: 600 — 10:00
slots[].to number да Конец интервала в минутах от полуночи, больше from и не больше 1440: 1140 — 19:00
slots[].weekDays array да Дни недели интервала: Mon, Tue, Wed, Thu, Fri, Sat, Sun. Нужен хотя бы один день
slots[].slotSize number да Длительность одного слота записи в минутах, не меньше 1. Дробная часть отбрасывается: 45.7 сохраняется как 45
slots[].timezone string да Часовой пояс, в котором заданы from и to, — имя из базы часовых поясов IANA, например Europe/Moscow. Смещение вида +03:00 не принимается

Других полей тело не принимает: поле рядом с slots отвечает 400 INVALID_PARAMS. Поле id из ответа чтения рабочих часов в элементе не учитывается: после записи интервалы получают новые id.

Примеры

curl — личный ключ

Terminal 
curl -X PUT "https://vibecode.bitrix24.tech/v1/booking-resources/65/slots" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slots": [
      { "from": 600, "to": 1140, "weekDays": ["Mon", "Tue", "Wed", "Thu", "Fri"], "slotSize": 30, "timezone": "Europe/Moscow" },
      { "from": 600, "to": 840, "weekDays": ["Sat"], "slotSize": 60, "timezone": "Europe/Moscow" }
    ]
  }'

curl — OAuth-приложение

Terminal 
curl -X PUT "https://vibecode.bitrix24.tech/v1/booking-resources/65/slots" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "slots": [
      { "from": 600, "to": 1140, "weekDays": ["Mon", "Tue", "Wed", "Thu", "Fri"], "slotSize": 30, "timezone": "Europe/Moscow" },
      { "from": 600, "to": 840, "weekDays": ["Sat"], "slotSize": 60, "timezone": "Europe/Moscow" }
    ]
  }'

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/booking-resources/65/slots', {
  method: 'PUT',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    slots: [
      { from: 600, to: 1140, weekDays: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri'], slotSize: 30, timezone: 'Europe/Moscow' },
      { from: 600, to: 840, weekDays: ['Sat'], slotSize: 60, timezone: 'Europe/Moscow' },
    ],
  }),
})

const { success, data } = await res.json()
console.log('Рабочие часы записаны:', data)

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/booking-resources/65/slots', {
  method: 'PUT',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    slots: [
      { from: 600, to: 1140, weekDays: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri'], slotSize: 30, timezone: 'Europe/Moscow' },
      { from: 600, to: 840, weekDays: ['Sat'], slotSize: 60, timezone: 'Europe/Moscow' },
    ],
  }),
})

const { success, data } = await res.json()

Поля ответа

Записанные интервалы в ответ не входят — их отдаёт GET /v1/booking-resources/:id/slots.

Поле Тип Описание
success boolean true при успехе
data boolean true — рабочие часы записаны

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

JSON 
{
  "success": true,
  "data": true
}

Пример ответа при ошибке

422 — диапазон времени или дни недели заданы неверно:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "Invalid range fields",
    "b24Code": "422"
  }
}

Ошибки

HTTP Код Описание
422 BITRIX_ERROR Invalid range fields — to не больше from, время вне диапазона от 0 до 1440, массив weekDays пустой или в нём неизвестный день. Рабочие часы не меняются
422 BITRIX_ERROR Required fields: from — в элементе нет from. Для to и weekDays сообщение называет своё поле
400 INVALID_PARAMS Provide slots as an array of objects — в теле нет slots, slots не массив, элемент массива не объект или рядом с slots есть другое поле
400 INVALID_PARAMS slotSize must be positive — в элементе нет slotSize или он меньше 1
400 INVALID_PARAMS slotSize must be a positive decimal number — slotSize передан строкой, в которой не число
400 INVALID_PARAMS timezone must be an IANA time zone — в элементе нет timezone, в нём смещение вида +03:00 или такого имени нет в базе часовых поясов IANA
400 INVALID_PARAMS id must be a positive safe integer — id ресурса не целое положительное число
404 ENTITY_NOT_FOUND Booking resource not found — ресурса с таким id нет
401 MISSING_API_KEY Не передан X-Api-Key
401 TOKEN_MISSING У ключа нет токенов Битрикс24
403 WRITE_BLOCKED_READONLY_KEY Ключ работает в режиме только для чтения. Запрос отклоняется до обращения к порталу
403 SCOPE_DENIED У ключа нет скоупа booking
429 RATE_LIMITED Превышена частота запросов. Действующий потолок — в заголовке x-ratelimit-limit
502 BITRIX_RESPONSE_INVALID Bitrix24 returned an invalid booking response — Битрикс24 не подтвердил запись

Полный список общих ошибок API — Ошибки.

Известные особенности

Не задавайте рабочие часы параллельно с правкой ресурса. Правка ресурса стирает рабочие часы, поэтому PATCH /v1/booking-resources/:id при заданных часах отвечает 422 BOOKING_RESOURCE_SCHEDULE_CONFLICT. Если часы записаны в промежутке между этой проверкой и самой правкой, правка их сотрёт, а оба запроса ответят успехом. После правки ресурса сверяйте часы через GET /v1/booking-resources/:id/slots.

Смотрите также