метод REST scope: calendar

calendar.accessibility.get

Получить занятость пользователей из списка

Кто может выполнять: любой пользователь

Описание

Метод получает занятость пользователей из списка.

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"from":"2024-06-20","to":"2024-12-20","users":[1,2,34]}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/calendar.accessibility.get

Ответ

HTTP-статус: 200

{
    "result": {
        "1": [
            {
                "ID": "1213",
                "NAME": "Event name",
                "DATE_FROM": "02.12.2024 11:00:00",
                "DATE_TO": "02.12.2024 12:00:00",
                "DATE_FROM_TS_UTC": "1733158800",
                "DATE_TO_TS_UTC": "1733162400",
                "~USER_OFFSET_FROM": -21600,
                "~USER_OFFSET_TO": -21600,
                "DT_SKIP_TIME": "N",
                "TZ_FROM": "America/Managua",
                "TZ_TO": "America/Managua",
                "ACCESSIBILITY": "busy",
                "IMPORTANCE": "normal",
                "EVENT_TYPE": "#collab#"
            },
            {
                "ID": "1216",
                ...
            }
        ],
        "2": [
            {
                "ID": 1,
                ...
            },
            {
                "ID": 2,
                ...
            }
        ],
        "34": []
    }
}

Возвращаемые данные

result object

Результат содержит объект.

Ключ объекта — это идентификатор пользователя из запроса.

Значение — массив объектов, каждый из которых описывает событие, в котором занят пользователь в указанный период

Обработка ошибок

HTTP-статус: 400

{
    "error": "",
    "error_description": "Не задан обязательный параметр \"from\" для метода \"calendar.accessibility.get\""
}
Код Описание Значение
— Не задан обязательный параметр "from" для метода "calendar.accessibility.get" Не передан обязательный параметр from
— Не задан обязательный параметр "to" для метода "calendar.accessibility.get" Не передан обязательный параметр to
— Не задан обязательный параметр "users" для метода "calendar.accessibility.get" Не передан обязательный параметр users
— Доступ запрещен Запрещен доступ к методу для внешних пользователей

Что будем искать? Например,Продвижение