метод REST scope: task

task.elapseditem.add

Добавить запись о затраченном времени

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

Описание

Метод task.elapseditem.add добавляет затраченное время к задаче. Возвращает идентификатор добавленной записи.

Проверить право на добавление можно специальным методом task.elapseditem.isactionallowed

Параметры

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

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

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

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

Объект, содержащий записи о пользователе, времени и комментарии (подробное описание приведено ниже) в виде структуры:

"ARFIELDS": {
    "SECONDS": "значение", 
    "COMMENT_TEXT": "значение",
    "USER_ID": "значение"
},

Параметр ARFIELDS

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

Количество затраченного времени в секундах

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

Текст комментария

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

Идентификатор пользователя

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID" : 691, "ARFIELDS": {"SECONDS": 113,"COMMENT_TEXT": "текст комментария"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.elapseditem.add

Ответ

HTTP-статус: 200

{
    "result": 5,
    "time":{
        "start":1712137817.343984,
        "finish":1712137817.605804,
        "duration":0.26182007789611816,
        "processing":0.018325090408325195,
        "date_start":"2024-04-03T12:50:17+03:00",
        "date_finish":"2024-04-03T12:50:17+03:00"
    }
}

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

result integer

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

time time

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

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

HTTP-статус: 400

{
    "error":"ERROR_CODE",
    "error_description":"ACTION_NOT_ALLOWED"
}
Код Описание Значение
0x000001 Задача не найдена
0x100002 Доступ запрещен
0x000004 Действие не разрешено
0x000040 Неизвестная ошибка

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

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