метод REST scope: task

task.elapseditem.getlist

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

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

Описание

Метод task.elapseditem.getlist возвращает список записей о затраченном времени по задаче.

Параметры

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

Идентификатор задачи.

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

order object необязательный

Объект для сортировки результата (подробное описание приведено ниже)

filter object необязательный

Объект для фильтрации результата (подробное описание приведено ниже)

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

Массив полей записей, которые будут возвращены методом. Можно указать только те поля, которые необходимы. Если в массиве присутствует значение "*", то будут возвращены все доступные поля.

По умолчанию будут возвращены все поля основной таблицы запроса

params object необязательный

Объект для опций вызова. Элементом является объект NAV_PARAMS вида {'опция вызова': 'значение' [, ...]} (подробное описание приведено ниже) в виде структуры

Параметр order

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

Идентификатор записи о затраченном времени. Может принимать значения:
- asc — по возрастанию
- desc — по убыванию

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

Идентификатор пользователя, от имени которого была сделана запись о затраченном времени. Может принимать значения:
- asc — по возрастанию
- desc — по убыванию

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

Затраченное время, минуты. Может принимать значения:
- asc — по возрастанию
- desc — по убыванию

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

Затраченное время, секунды. Может принимать значения:
- asc — по возрастанию
- desc — по убыванию

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

Дата создания записи. Может принимать значения:
- asc — по возрастанию
- desc — по убыванию

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

Дата начала. Может принимать значения:
- asc — по возрастанию
- desc — по убыванию

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

Дата конца. Может принимать значения:
- asc — по возрастанию
- desc — по убыванию

Параметр filter

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

Идентификатор записи о затраченном времени

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

Идентификатор пользователя, от имени которого была сделана запись о затраченном времени

CREATED_DATE datetime необязательный

Дата создания записи

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

Количество элементов на странице. В целях ограничения нагрузки на постраничную навигацию наложено ограничение в 50 записей

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

Номер страницы при постраничной навигации

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '[3839,{"ID":"asc"},{"USER_ID":1},["ID","TASK_ID","USER_ID","SECONDS","MINUTES","COMMENT_TEXT","CREATED_DATE"],{"NAV_PARAMS":{"nPageSize":2,"iNumPage":1}}]' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.elapseditem.getlist

Ответ

HTTP-статус: 200

{
    "result":[
        {
            "ID": "153",
            "TASK_ID": "3839",
            "USER_ID": "1",
            "COMMENT_TEXT": "",
            "SECONDS": "5100",
            "MINUTES": "85",
            "CREATED_DATE": "2025-12-18T14:16:51+03:00"
        },
        {
            "ID": "155",
            "TASK_ID": "3839",
            "USER_ID": "1",
            "COMMENT_TEXT": "",
            "SECONDS": "23",
            "MINUTES": "0",
            "CREATED_DATE": "2025-12-18T14:16:37+03:00"
        }
    ],
    "total": 2,
    "time":{
        "start":1787829762,
        "finish":1787829762.985642,
        "duration":0.9856419563293457,
        "processing":0,
        "date_start":"2026-08-27T14:22:42+03:00",
        "date_finish":"2026-08-27T14:22:42+03:00",
        "operating_reset_at":1787830362,
        "operating":0.11980605125427246
    }
}

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

result array

Массив объектов с информацией о записях о затраченном времени по задаче

total integer

Общее количество найденных записей

time time

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

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

HTTP-статус: 400

{
    "error":"ERROR_CORE",
    "error_description":"ACTION_NOT_ALLOWED"
}
Код Описание Значение
0x100002 Доступ запрещен
0x000004 Действие не разрешено
0x000040 Неизвестная ошибка
0x000100 Переданы неверные параметры метода
ERROR_CORE Ошибка выполнения действия. Проверьте доступ к задаче и порядок позиционных параметров метода

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

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