метод REST scope: timeman

timeman.timecontrol.settings.set

Установить настройки контроля времени

Кто может выполнять: администратор

Описание

Метод timeman.timecontrol.settings.set устанавливает настройки для модуля контроля времени.

Сбор данных контроля времени начинается с момента активации соответствующих настроек регистрации. Получить данные за период до активации невозможно — система не сохраняет историческую информацию ретроспективно.

Параметры

ACTIVE boolean необязательный

Активировать модуль контроля времени. Возможные значения:
- true или 1 — включить модуль
- 0 — отключить модуль. Вариант 'ACTIVE': false модуль не отключает

MINIMUM_IDLE_FOR_REPORT integer необязательный

Минимальное время отсутствия в минутах, после которого требуется отчет

REGISTER_OFFLINE boolean необязательный

Регистрировать офлайн статус

REGISTER_IDLE boolean необязательный

Регистрировать статус Отошел

REGISTER_DESKTOP boolean необязательный

Регистрировать статус десктоп приложения

REPORT_REQUEST_TYPE string необязательный

Тип запроса отчетов. Возможные значения:
- all — для всех
- user — для конкретных пользователей
- none — ни для кого

REPORT_REQUEST_USERS array необязательный

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

Заполняется, если REPORT_REQUEST_TYPE имеет значение user

REPORT_SIMPLE_TYPE string необязательный

Тип простого отчета. Возможные значения:
- all — для всех
- user — для конкретных пользователей
- none — ни для кого

REPORT_SIMPLE_USERS array необязательный

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

Заполняется, если REPORT_SIMPLE_TYPE имеет значение user

REPORT_FULL_TYPE string необязательный

Тип полного отчета. Возможные значения:
- all — для всех
- user — для конкретных пользователей
- none — ни для кого

REPORT_FULL_USERS array необязательный

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

Заполняется, если REPORT_FULL_TYPE имеет значение user

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ACTIVE":true,"MINIMUM_IDLE_FOR_REPORT":15,"REGISTER_OFFLINE":true,"REGISTER_IDLE":true,"REGISTER_DESKTOP":true,"REPORT_REQUEST_TYPE":"all","REPORT_SIMPLE_TYPE":"all","REPORT_FULL_TYPE":"all"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/timeman.timecontrol.settings.set

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1748526089.625516,
        "finish": 1748526089.656787,
        "duration": 0.03127098083496094,
        "processing": 0.008746147155761719,
        "date_start": "2025-05-29T16:41:29+03:00",
        "date_finish": "2025-05-29T16:41:29+03:00",
        "operating_reset_at": 1748526689,
        "operating": 0
    }
}

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

result boolean

Результат выполнения.

Возвращает true, если настройки успешно сохранены

time time

Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": "ACCESS_ERROR",
    "error_description": "You don't have access to use this method"
}
Код Описание Значение
ACCESS_ERROR You don't have access to use this method У вас нет доступа к этому методу

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

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.