Для 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 — личный ключ
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-приложение
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 — личный ключ
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-приложение
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. У событий календаря поля нет |
Пример ответа
{
"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:
{
"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 — Ошибки.