get_task_messages

Для загрузки сообщений задач для объектов используйте метод messages/get_task_messages.

Чтобы получить сообщения о задачах, необходимы права доступа Просмотр элемента и его основных свойств и Запрос сообщений и отчетов на объекты. Для учетной записи должна быть включена и активирована услуга Задачи.

Конечная точка

Copied!

svc=messages/get_task_messages&params={
	"itemIds": [<long>],
	"timeFrom":<uint>,
    "timeTo":<uint>,
    "loadCount":<uint>
}

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

Copied!

https://hst-api.wialon.com/wialon/ajax.html?sid=ИДЕНТИФИКАТОР_СЕССИИ&svc=messages/get_task_messages&params={
        "itemIds":[1546, 1545],
        "timeFrom": 1724347800,
        "timeTo": 1724693399,
        "loadCount": 10000
}

Параметры

Ниже перечислены обязательные параметры.

Параметр	Описание
`itemIds`	Массив идентификаторов объектов, для которых запрашиваются сообщения о задачах.
`timeFrom`	Начало интервала (Unix time, UTC).
`timeTo`	Конец интервала (Unix time, UTC). Должен быть больше или равен `timeFrom`.
`loadCount`	Количество сообщений для загрузки. Максимальное значение — 20000.

Возвращаемый результат

При успешном выполнении запроса в ответе содержится количество сообщений о задачах и массив сообщений.

Copied!

{
    "count": 5,
    "messages": [
        {
            "item_id": 1546,
            "t": 1724420460,
            "f": 1536,
            "tp": "task",
            "et": "adf",
            "x": 0,
            "y": 0,
            "rt": 1724420493,
            "p": {
                "task_sub_type": 21,
                "task_reg_type": 1,
                "task_evt_name": "Custom task",
                "task_id": "b1978b93a308c5c3be0697223bf0c5002ee87de02ce7937b23a34830516c330466c8916c",
                "task_update_time": 1724420460,
                "task_status": 6,
                "task_priority": 2,
                "task_assignee": 0,
                "task_description": "VHS Glitch violated speed limitations.",
                "task_tags": "{\"SPEED\":\"25 km/h\",\"POS_TIME\":\"10.07.2025 15:52:28\",\"UNIT\":\"VHS Glitch\"}",
                "task_comments": "[]",
                "task_account": 1063,
                "task_address_x": 56.65078,
                "task_address_y": 53,
                "task_done_rejected": 1752152438,
                "task_params": {}
            }
        },
        {
            "item_id": 1546,
            "t": 1724420460,
            "f": 1536,
            "tp": "task",
            "et": "adf",
            "x": 0,
            "y": 0,
            "rt": 1724420497,
            "p": {
                "task_sub_type": 21,
                "task_reg_type": 1,
                "task_evt_name": "Custom task",
                "task_id": "c52f1f15dd9a2c5b3258102cde5ad75a24b76820b4cf0d2438c835d796a2fd5966c8916c",
                "task_update_time": 1724420460,
                "task_status": 6,
                "task_priority": 2,
                "task_assignee": 0,
                "task_description": "VHS Glitch violated speed limitations.",
                "task_tags": "{\"SPEED\":\"25 km/h\",\"POS_TIME\":\"10.07.2025 15:52:28\",\"UNIT\":\"VHS Glitch\"}",
                "task_comments": "[]",
                "task_account": 1063,
                "task_address_x": 56.65078,
                "task_address_y": 53,
                "task_done_rejected": 1752152438,
                "task_params": {}
            }
        },
        {
            "item_id": 1546,
            "t": 1724420460,
            "f": 1536,
            "tp": "task",
            "et": "adf",
            "x": 0,
            "y": 0,
            "rt": 1724420496,
            "p": {
                "task_sub_type": 21,
                "task_reg_type": 1,
                "task_evt_name": "Custom task",
                "task_id": "cec6ce7c7bb4ae44304494eb6659e2952ad3ca0dab62093e2482403d62b1157466c8916c",
                "task_update_time": 1724420460,
                "task_status": 6,
                "task_priority": 2,
                "task_assignee": 0,
                "task_description": "VHS Glitch violated speed limitations.",
                "task_tags": "{\"SPEED\":\"25 km/h\",\"POS_TIME\":\"10.07.2025 15:52:28\",\"UNIT\":\"VHS Glitch\"}",
                "task_comments": "[]",
                "task_account": 1063,
                "task_address_x": 56.65078,
                "task_address_y": 53,
                "task_done_rejected": 1752152438,
                "task_params": {}
            }
        },
        {
            "item_id": 1546,
            "t": 1724420460,
            "f": 1536,
            "tp": "task",
            "et": "adf",
            "x": 0,
            "y": 0,
            "rt": 1724420494,
            "p": {
                "task_sub_type": 21,
                "task_reg_type": 1,
                "task_evt_name": "Custom task",
                "task_id": "7674dbcfae5776e0847d7239401c0b9384a99226c0245b9501ba8917b38e8d6b66c8916c",
                "task_update_time": 1724420460,
                "task_status": 6,
                "task_priority": 2,
                "task_assignee": 0,
                "task_description": "VHS Glitch violated speed limitations.",
                "task_tags": "{\"SPEED\":\"25 km/h\",\"POS_TIME\":\"10.07.2025 15:52:28\",\"UNIT\":\"VHS Glitch\"}",
                "task_comments": "[]",
                "task_account": 1063,
                "task_address_x": 56.65078,
                "task_address_y": 53,
                "task_done_rejected": 1752152438,
                "task_params": {}
            }
        },
        {
            "item_id": 1546,
            "t": 1724420460,
            "f": 1536,
            "tp": "task",
            "et": "adf",
            "x": 0,
            "y": 0,
            "rt": 1724420495,
            "p": {
                "task_sub_type": 21,
                "task_reg_type": 1,
                "task_evt_name": "Custom task",
                "task_id": "e15b634b9750481a951ffac6bbbbd76411669aa829c78c925b5b2f08b3f5a77066c8916c",
                "task_update_time": 1724420460,
                "task_status": 6,
                "task_priority": 2,
                "task_assignee": 0,
                "task_description": "VHS Glitch violated speed limitations.",
                "task_tags": "{\"SPEED\":\"25 km/h\",\"POS_TIME\":\"10.07.2025 15:52:28\",\"UNIT\":\"VHS Glitch\"}",
                "task_comments": "[]",
                "task_account": 1063,
                "task_address_x": 56.65078,
                "task_address_y": 53,
                "task_done_rejected": 1752152438,
                "task_params": {}
            }
        }
    ]
}

Если запрос не выполнен, возвращается код ошибки.

Коды ошибок

Код	Описание
4	Невалидные входные параметры (например, `timeFrom` > `timeTo` или отсутствуют обязательные поля).
5	Ошибка выполнения запроса.
7	Доступ запрещен. Отсутствуют необходимые права доступа на объекты или услуга Задачи не включена или не активирована.
1004	Превышено максимальное количество сообщений (параметр `loadCount`).