метод REST scope: task

tasks.task.counters.get

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

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

Описание

Метод tasks.task.counters.get получает значения счетчиков задач для указанного пользователя.

Параметры

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

Идентификатор пользователя, для которого нужно получить счетчики.

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

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

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

Идентификатор группы, для задач которой нужно получилось счетчики.

Передайте 0 или не указывайте параметр, чтобы учитывать все группы.

Получить идентификатор можно методом создания новой группы или методом получения списка групп.

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

Роль, для которой нужно получить счетчики. Возможные роли:
- view_all — все роли
- view_role_responsible — делаю
- view_role_accomplice — помогаю
- view_role_auditor — наблюдаю
- view_role_originator — поручил

По умолчанию используется роль view_all

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"userId":547,"groupId":0,"type":"view_all"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.counters.get

Ответ

HTTP-статус: 200

{
    "result": {
        "expired": {
            "counter": 1,
            "code": 6291456
        },
        "new_comments": {
            "counter": 7,
            "code": 12582912
        }
    },
    "total": 1,
    "time": {
        "start": 1758868152,
        "finish": 1758868152.929809,
        "duration": 0.9298090934753418,
        "processing": 0,
        "date_start": "2025-09-26T09:29:12+03:00",
        "date_finish": "2025-09-26T09:29:12+03:00",
        "operating_reset_at": 1758868752,
        "operating": 0
    }
}

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

result object

Объект, в котором ключ — название счетчика, а значение — объект с описанием счетчика.

Значения счетчиков:
- new_comments — непрочитанные комментарии
- expired — просроченные задачи

Возвращает пустой массив "result":[], если пользователь не существует или нет прав на получение счетчиков указанного пользователя

total integer

На текущий момент не используется. Всегда возвращает значение 1

time time

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

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

HTTP-статус: 400

{
    "error": "0",
    "error_description": "Group not found or access denied. (internal error)"
}
Код Описание Значение
0 Invalid value {value} to match with parameter {userId}. Should be value of type int. В параметре userId указано значение неверного типа
0 Group not found or access denied. (internal error) Группа не существует или к ней нет прав доступа

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

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