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

Записать из листа ожидания

POST /v1/booking-wait-list/:id/booking

Создаёт бронь по записи листа ожидания: клиенты записи переходят в новую бронь, а сама запись удаляется из листа.

Поля передаются в корне JSON, без обёртки fields. Сообщения клиенту о записи зависят от переключателей is*NotificationOn ресурса бронирования.

Параметры

Параметр	Тип	Обяз.	Описание
`id` (path)	number	да	Идентификатор записи листа ожидания. Список: `GET /v1/booking-wait-list`

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

Поле	Тип	Обяз.	Описание
`resourceIds`	number[]	да	Идентификаторы ресурсов, которые резервирует бронь. Массив не может быть пустым. Список: `GET /v1/booking-resources`
`datePeriod.from.timestamp`	number	да	Начало брони, Unix-время в секундах
`datePeriod.from.timezone`	string	да	Часовой пояс начала в формате IANA, например `Europe/Moscow`
`datePeriod.to.timestamp`	number	да	Окончание брони, Unix-время в секундах. Должно быть позже начала
`datePeriod.to.timezone`	string	да	Часовой пояс окончания в формате IANA

Других полей тело не принимает. Название и описание брони задаёт изменение бронирования.

Примеры

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

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/booking-wait-list/27/booking" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resourceIds": [49],
    "datePeriod": {
      "from": { "timestamp": 1795158000, "timezone": "Europe/Moscow" },
      "to": { "timestamp": 1795161600, "timezone": "Europe/Moscow" }
    }
  }'

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

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/booking-wait-list/27/booking" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "resourceIds": [49],
    "datePeriod": {
      "from": { "timestamp": 1795158000, "timezone": "Europe/Moscow" },
      "to": { "timestamp": 1795161600, "timezone": "Europe/Moscow" }
    }
  }'

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/booking-wait-list/27/booking', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    resourceIds: [49],
    datePeriod: {
      from: { timestamp: 1795158000, timezone: 'Europe/Moscow' },
      to: { timestamp: 1795161600, timezone: 'Europe/Moscow' },
    },
  }),
})

const { data } = await res.json()
console.log('Booking ID:', data.id)

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/booking-wait-list/27/booking', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    resourceIds: [49],
    datePeriod: {
      from: { timestamp: 1795158000, timezone: 'Europe/Moscow' },
      to: { timestamp: 1795161600, timezone: 'Europe/Moscow' },
    },
  }),
})

const { data } = await res.json()
console.log('Booking ID:', data.id)

Поля ответа

При успехе возвращается HTTP-статус 201 Created и карточка новой брони — та же, что у GET /v1/bookings/:id.

Поле	Тип	Описание
`success`	boolean	`true` при успехе
`data.id`	number	Идентификатор брони. Клиентов брони возвращает `GET /v1/bookings/:id/clients`
`data.name`	string \| null	Название брони
`data.description`	string \| null	Описание брони
`data.resourceIds`	number[]	Идентификаторы зарезервированных ресурсов
`data.datePeriod`	object	Период брони: `from` и `to`, у каждого `timestamp` и `timezone`

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

JSON

{
  "success": true,
  "data": {
    "datePeriod": {
      "from": {
        "timestamp": 1795158000,
        "timezone": "Europe/Moscow"
      },
      "to": {
        "timestamp": 1795161600,
        "timezone": "Europe/Moscow"
      }
    },
    "description": null,
    "id": 49,
    "name": null,
    "resourceIds": [
      49
    ]
  }
}

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

404 — записи листа ожидания с таким id нет, например она уже перенесена в бронь: