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

Занятость сотрудников

GET /v1/calendar/accessibility

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

Общий параметр filter этим эндпоинтом не применяется. По умолчанию API сохраняет прежний ответ HTTP 200 и прежние данные, добавляет заголовок Warning: 299 - "filter is not supported on this endpoint and was ignored", а сервер фиксирует использование неподдерживаемого фильтра в журнале.

Параметры

Параметр Тип Обяз. Описание
ПараметрuserIds (query) Типstring Обяз.да ОписаниеID сотрудников через запятую. Список: GET /v1/users
Параметрfrom (query) Типstring Обяз.да ОписаниеНачало периода: дата 2026-10-01 или дата и время в ISO 8601
Параметрto (query) Типstring Обяз.да ОписаниеКонец периода в том же формате

Примеры

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

Terminal
curl -G https://vibecode.bitrix24.tech/v1/calendar/accessibility \
  --data-urlencode "userIds=1295" \
  --data-urlencode "from=2026-10-01" \
  --data-urlencode "to=2026-10-31" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal
curl -G https://vibecode.bitrix24.tech/v1/calendar/accessibility \
  --data-urlencode "userIds=1295" \
  --data-urlencode "from=2026-10-01" \
  --data-urlencode "to=2026-10-31" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript
const params = new URLSearchParams({ userIds: '1295', from: '2026-10-01', to: '2026-10-31' })
const res = await fetch(`https://vibecode.bitrix24.tech/v1/calendar/accessibility?${params}`, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { data } = await res.json()

for (const [userId, intervals] of Object.entries(data)) {
  console.log(userId, intervals.map((i) => `${i.from} — ${i.to}`))
}

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

javascript
const params = new URLSearchParams({ userIds: '1295', from: '2026-10-01', to: '2026-10-31' })
const res = await fetch(`https://vibecode.bitrix24.tech/v1/calendar/accessibility?${params}`, {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean ОписаниеВсегда true при успехе
Полеdata Типobject ОписаниеЗанятость по сотрудникам: ключ — ID сотрудника из userIds, значение — массив занятых интервалов. Пустой массив — в периоде нет занятых интервалов, видимых владельцу ключа
Полеdata.<userId>[].id Типnumber ОписаниеID события календаря или записи графика отсутствий
Полеdata.<userId>[].name Типstring ОписаниеНазвание события. У приватного события другого сотрудника и у события, название которого владельцу ключа не видно, вместо названия приходит занятость в квадратных скобках. У записи графика отсутствий поля нет
Полеdata.<userId>[].from Типstring ОписаниеНачало интервала: дата и время в ISO 8601 со смещением. У события на весь день — дата без времени
Полеdata.<userId>[].to Типstring ОписаниеКонец интервала в том же формате. У события на весь день — последний день события включительно
Полеdata.<userId>[].timezoneFrom Типstring ОписаниеЧасовой пояс начала, например Europe/Moscow. У события на весь день поля нет
Полеdata.<userId>[].timezoneTo Типstring ОписаниеЧасовой пояс конца. У события на весь день поля нет
Полеdata.<userId>[].skipTime Типboolean Описаниеtrue — событие на весь день
Полеdata.<userId>[].accessibility Типstring ОписаниеЗанятость в интервале, например busy. У записи графика отсутствий — absent
Полеdata.<userId>[].importance Типstring ОписаниеВажность события, например normal
Полеdata.<userId>[].eventType Типstring | null ОписаниеТип события. null у события без особого типа
Полеdata.<userId>[].fromHr Типboolean Описаниеtrue у записи графика отсутствий. Время такой записи приходит в UTC. У событий календаря поля нет

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

JSON
{
  "success": true,
  "data": {
    "1295": [
      {
        "from": "2026-10-15T10:00:00+03:00",
        "to": "2026-10-15T11:00:00+03:00",
        "id": 8339,
        "name": "Планёрка отдела",
        "accessibility": "busy",
        "importance": "normal",
        "eventType": null,
        "timezoneFrom": "Europe/Moscow",
        "timezoneTo": "Europe/Moscow",
        "skipTime": false
      },
      {
        "from": "2026-10-19",
        "to": "2026-10-20",
        "id": 8341,
        "name": "Командировка",
        "accessibility": "absent",
        "importance": "normal",
        "eventType": null,
        "skipTime": true
      }
    ]
  }
}

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

400 — дата в from не в формате ISO 8601:

JSON
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "from must be an ISO date"
  }
}

Ошибки

HTTP Код Описание
HTTP200 КодWarning: 299 ОписаниеФильтр игнорируется по умолчанию; прежние данные сохраняются, предупреждение передаётся заголовком Warning.
HTTP400 только при включённом строгом режиме КодUNSUPPORTED_FILTER ОписаниеСерверный режим выключен по умолчанию; до его включения эндпоинт сохраняет HTTP 200 и прежние данные.
HTTP400 КодMISSING_REQUIRED_FIELDS ОписаниеНе передан userIds, from или to, либо в userIds есть значение, которое не является положительным целым числом
HTTP400 КодINVALID_PARAMS Описаниеfrom или to не в формате ISO 8601
HTTP401 КодTOKEN_MISSING ОписаниеУ API-ключа не настроены токены
HTTP403 КодSCOPE_DENIED ОписаниеКлючу не хватает скоупа calendar
HTTP403 КодBITRIX_ACCESS_DENIED ОписаниеБитрикс24 запретил доступ
HTTP422 КодBITRIX_ERROR ОписаниеБитрикс24 отклонил запрос
HTTP429 КодRATE_LIMITED ОписаниеПревышен лимит запросов
HTTP502 КодBITRIX_UNAVAILABLE ОписаниеБитрикс24 недоступен или вернул ответ неверной формы
HTTP503 КодBITRIX_TIMEOUT ОписаниеБитрикс24 не ответил вовремя

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

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