метод REST scope: task Устаревший

task.commentitem.getlist

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

Устаревший метод. Развитие метода остановлено с версии модуля tasks 25.700.0. Метод task.commentitem.getlist не работает в новой карточке задач, используйте метод im.dialog.messages.get для работы с чатом задач.

Кто может выполнять: любой пользователь с правом доступа на чтение задачи или выше

Описание

Метод task.commentitem.getlist получает список комментариев задачи.

Параметры

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

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

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

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

Объект для сортировки результата вида {"поле": "значение сортировки", ... }.

Сортировать можно по полям:
- ID — идентификатор комментария
- AUTHOR_ID — идентификатор автора комментария
- AUTHOR_NAME — имя автора
- AUTHOR_EMAIL — почтовый адрес автора
- POST_DATE — дата публикации комментария

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

По умолчанию результат сортируется по убыванию идентификатора комментария

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

Объект для фильтрации результата вида {"поле": "значение фильтра", ... }. Значением фильтруемого поля может быть одиночное значение или массив значений.

Фильтровать можно по полям:
- ID — идентификатор комментария
- AUTHOR_ID — идентификатор автора комментария
- AUTHOR_NAME — имя автора
- POST_DATE — дата публикации комментария

Перед названием фильтруемого поля можно указать префикс с типом фильтрации:
- ! — не равно
- <=— меньше либо равно
- < — меньше
- >=— больше либо равно
- > — больше

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

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":8017,"ORDER":{"POST_DATE":"asc"},"FILTER":{"AUTHOR_ID":503,">=POST_DATE":"2025-01-01"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.commentitem.getlist

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "POST_MESSAGE_HTML": null,
            "ID": "3157",
            "AUTHOR_ID": "503",
            "AUTHOR_NAME": "Иван Иванов",
            "AUTHOR_EMAIL": "",
            "POST_DATE": "2025-07-15T14:31:00+03:00",
            "POST_MESSAGE": "Фотографии во вложении",
            "ATTACHED_OBJECTS": {
                "973": {
                    "ATTACHMENT_ID": "973",
                    "NAME": "photo1.png",
                    "SIZE": "1495700",
                    "FILE_ID": "4755",
                    "DOWNLOAD_URL": "/bitrix/tools/disk/uf.php?attachedId=973&auth%5Bauth%5D=3edf7ca92&action=download&ncc=1",
                    "VIEW_URL": "/bitrix/tools/disk/uf.php?attachedId=973&auth%5Bauth%5D=3edf7ca92&action=show&ncc=1"
                },
                "975": {
                    "ATTACHMENT_ID": "975",
                    "NAME": "photo2.png",
                    "SIZE": "1017053",
                    "FILE_ID": "4753",
                    "DOWNLOAD_URL": "/bitrix/tools/disk/uf.php?attachedId=975&auth%5Bauth%5D=3edf7ca92&action=download&ncc=1",
                    "VIEW_URL": "/bitrix/tools/disk/uf.php?attachedId=975&auth%5Bauth%5D=3edf7ca92&action=show&ncc=1"
                }
            }
        },
        {
            "POST_MESSAGE_HTML": null,
            "ID": "3155",
            "AUTHOR_ID": "503",
            "AUTHOR_NAME": "Иван Иванов",
            "AUTHOR_EMAIL": "",
            "POST_DATE": "2025-07-15T14:30:00+03:00",
            "POST_MESSAGE": "Подготовил новые фотографии",
            "ATTACHED_OBJECTS": {}
        }
    ],
    "time": {
        "start": 1753270901.224447,
        "finish": 1753270901.343166,
        "duration": 0.11871910095214844,
        "processing": 0.06380701065063477,
        "date_start": "2025-07-23T14:41:41+03:00",
        "date_finish": "2025-07-23T14:41:41+03:00",
        "operating_reset_at": 1753271501,
        "operating": 0
    }
}

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

result array

Массив объектов. Каждый объект содержит описание комментария

POST_MESSAGE_HTML string

HTML-код комментария

ID string

Идентификатор комментария

AUTHOR_ID string

Идентификатор автора комментария

AUTHOR_NAME string

Имя автора комментария

AUTHOR_EMAIL string

Email автора комментария

POST_DATE string

Дата и время создания комментария

POST_MESSAGE string

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

ATTACHED_OBJECTS object

Объект, содержащий информацию о вложениях. Ключ объекта — идентификатор вложения, а значение — объект с описанием файла

time time

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

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

HTTP-статус: 400

{
    "error":"ERROR_CORE",
    "error_description":"TASKS_ERROR_EXCEPTION_#256; Param #1 (arOrder) for method ctaskcommentitem::getlist() must not contain key ">=POST_DATE".; 256/TE/WRONG_ARGUMENTS.<br>"
}
Код Описание Значение
ERROR_CORE TASKS_ERROR_EXCEPTION_#8; Action failed; 8/TE/ACTION_FAILED_TO_BE_PROCESSED Указано неверное значение параметра или нет прав доступа к задаче
ERROR_CORE TASKS_ERROR_EXCEPTION_#256; Param #0 (taskId) for method ctaskcommentitem::getlist() expected to be of type "integer", but given something else.; 256/TE/WRONG_ARGUMENTS Указан неверный тип значения для параметра, например, для TASKID
ERROR_CORE TASKS_ERROR_EXCEPTION_#256; Param #1 (arOrder) for method ctaskcommentitem::getlist() must not contain key ">=POST_DATE".; 256/TE/WRONG_ARGUMENTS Параметры указаны в неверном порядке
ERROR_CORE TASKS_ERROR_EXCEPTION_#256; Param #2 (arFilter) for method ctaskcommentitem::getlist() must not contain key "%POST_DATE".; 256/TE/WRONG_ARGUMENTS Неверно указано название параметра или префикс для фильтра

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

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