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

Карточка: Типы ресурсов бронирования

GET /v1/booking-resource-types/:id

Возвращает тип ресурса бронирования по идентификатору: название, код и настройки сообщений клиентам о записи.

Параметры

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

Примеры

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/booking-resource-types/31" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/booking-resource-types/31" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/booking-resource-types/31', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const { data } = await res.json()
console.log(data.name, data.code)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/booking-resource-types/31', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { data } = await res.json()
console.log(data.name, data.code)

Поля ответа

Переключатели is*NotificationOn в ответе всегда true или false, даже если при записи передавались строки "Y" / "N". Задержки — в секундах.

Поле Тип Описание
success boolean true при успехе
data.id number Идентификатор типа. Его передают в typeId при создании ресурса бронирования
data.code string Символьный код типа, уникален среди типов портала
data.name string Название типа
data.senderCode string | null Служба отправки сообщений клиенту, например bitrix24. null — не задана
data.isInfoNotificationOn boolean Сообщение клиенту о записи
data.isConfirmationNotificationOn boolean Запрос подтверждения записи
data.isReminderNotificationOn boolean Напоминание о записи
data.isFeedbackNotificationOn boolean Запрос отзыва
data.isDelayedNotificationOn boolean Сообщение клиенту, который опаздывает
data.isCancellationNotificationOn boolean Сообщение клиенту об отмене записи
data.infoNotificationDelay number | null Через сколько секунд после записи отправить сообщение о ней
data.confirmationNotificationDelay number | null За сколько секунд до записи отправить первый запрос подтверждения
data.confirmationNotificationRepetitions number | null Сколько раз повторить запрос подтверждения, не считая первого
data.confirmationNotificationRepetitionsInterval number | null Интервал между повторами запроса подтверждения
data.confirmationCounterDelay number | null За сколько секунд до записи неподтверждённая запись попадает в счётчик
data.reminderNotificationDelay number | null За сколько секунд до записи отправить напоминание. -1 — утром в день записи
data.delayedNotificationDelay number | null Через сколько секунд опоздания отправить сообщение клиенту
data.delayedCounterDelay number | null Через сколько секунд опоздания запись попадает в счётчик календаря
data.cancellationNotificationDelay number | null Задержка сообщения об отмене записи
data.templateTypeConfirmation string Шаблон запроса подтверждения: inanimate, animate, inanimate_long
data.templateTypeReminder string Шаблон напоминания, base
data.templateTypeFeedback string Шаблон запроса отзыва: inanimate, animate
data.templateTypeDelayed string Шаблон сообщения опоздавшему: inanimate, animate

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

JSON 
{
  "success": true,
  "data": {
    "id": 31,
    "code": "master",
    "name": "Мастера",
    "senderCode": null,
    "isInfoNotificationOn": false,
    "isConfirmationNotificationOn": false,
    "isReminderNotificationOn": false,
    "isFeedbackNotificationOn": false,
    "isDelayedNotificationOn": false,
    "isCancellationNotificationOn": false,
    "infoNotificationDelay": null,
    "confirmationNotificationDelay": 86400,
    "confirmationNotificationRepetitions": null,
    "confirmationNotificationRepetitionsInterval": 10800,
    "confirmationCounterDelay": 10800,
    "reminderNotificationDelay": -1,
    "delayedNotificationDelay": 300,
    "delayedCounterDelay": 300,
    "cancellationNotificationDelay": 600,
    "templateTypeConfirmation": "inanimate",
    "templateTypeReminder": "base",
    "templateTypeFeedback": "inanimate",
    "templateTypeDelayed": "inanimate"
  }
}

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

404 — типа с таким id нет:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Booking record not found"
  }
}

Ошибки

HTTP Код Описание
404 ENTITY_NOT_FOUND Типа с таким id нет
400 INVALID_PARAMS id — не целое положительное число. Сообщение id must be a positive safe integer
401 MISSING_API_KEY Не передан X-Api-Key
401 TOKEN_MISSING У ключа нет токенов Битрикс24
403 SCOPE_DENIED У ключа нет скоупа booking
429 RATE_LIMITED Превышена частота запросов. Действующий потолок — в заголовке x-ratelimit-limit
502 BITRIX_RESPONSE_INVALID Битрикс24 вернул карточку неожиданной формы

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

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

Ресурсы типа — отдельным запросом. Карточка типа не перечисляет его ресурсы. Чтобы получить их, вызовите GET /v1/booking-resources?typeId=31.

Шаблон сообщения о записи в карточке не возвращается. Поле templateTypeInfo принимают создание и правка, но в карточке его нет. Прочитать текущий шаблон через API нельзя.

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