get_task_messages
Для загрузки сообщений задач для объектов используйте метод messages/get_task_messages.
В Wialon Local этот метод доступен начиная с версии 2504.
Чтобы получить сообщения о задачах, необходимы права доступа Просмотр элемента и его основных свойств и Запрос сообщений и отчетов на объекты. Для учетной записи должна быть включена и активирована услуга Задачи.
Конечная точка
svc=messages/get_task_messages¶ms={
"itemIds": [<long>],
"timeFrom":<uint>,
"timeTo":<uint>,
"loadCount":<uint>
}
Пример запроса
https://hst-api.wialon.com/wialon/ajax.html?sid=ИДЕНТИФИКАТОР_СЕССИИ&svc=messages/get_task_messages¶ms={
"itemIds":[1546, 1545],
"timeFrom": 1724347800,
"timeTo": 1724693399,
"loadCount": 10000
}
Параметры
Ниже перечислены обязательные параметры.
| Параметр | Описание |
|---|---|
itemIds |
Массив идентификаторов объектов, для которых запрашиваются сообщения о задачах. |
timeFrom |
Начало интервала (Unix time, UTC). |
timeTo |
Конец интервала (Unix time, UTC). Должен быть больше или равен timeFrom. |
loadCount |
Количество сообщений для загрузки. Максимальное значение — 20000. |
Ответ
При успешном выполнении запроса в ответе содержится количество сообщений о задачах и массив сообщений. Каждое сообщение содержит ID объекта (item_id), время сообщения (t), флаги сообщения (f, для задач всегда 20480) и параметры задачи (p). Сообщения отсортированы по времени, от самых старых к самым новым. Если найденных сообщений больше, чем указано в loadCount, возвращаются только самые новые из них.
{
"count": 2,
"messages": [
{
"item_id": 1546,
"t": 1724420460,
"f": 20480,
"p": {
"task_id": "b1978b93a308c5c3be0697223bf0c5002ee87de02ce7937b23a34830516c330466c8916c",
"task_sub_type": "speed",
"task_reg_type": 2,
"task_account": 1063,
"task_status": 6,
"task_description": "VHS Glitch violated speed limitations.",
"task_priority": 2,
"task_assignee": 0,
"task_evt_name": "Speeding",
"task_tags": "{\"SPEED\":\"25 km/h\",\"POS_TIME\":\"10.07.2025 15:52:28\",\"UNIT\":\"VHS Glitch\"}",
"task_comments": [
{
"id": 1,
"timestamp": 1724420600,
"assignee": 1039,
"last_edited_by": 0,
"last_edit_time": 0,
"comment": "The driver has been notified."
}
],
"task_update_time": 1724420600,
"task_address_x": 56.65078,
"task_address_y": 53,
"task_done_rejected": 1724420600,
"task_params": {}
}
},
{
"item_id": 1545,
"t": 1724506800,
"f": 20480,
"p": {
"task_id": "c52f1f15dd9a2c5b3258102cde5ad75a24b76820b4cf0d2438c835d796a2fd5966c8916c",
"task_sub_type": "fuel_filling",
"task_reg_type": 1,
"task_account": 1063,
"task_status": 1,
"task_description": "Refuel before the next trip.",
"task_priority": 3,
"task_assignee": 1039,
"task_evt_name": "Fuel filling",
"task_tags": "",
"task_comments": [],
"task_update_time": 1724506800,
"task_address_x": 56.65078,
"task_address_y": 53,
"task_done_rejected": 0,
"task_params": {
"filled": 40,
"cost": 60.5
}
}
}
]
}
Описание параметров задачи и значения task_reg_type, task_status и task_priority приведены в разделе Задача. Значения task_sub_type приведены в разделе Подтипы событий и задач.
Если запрос не выполнен, возвращается код ошибки.
Коды ошибок
| Код | Описание |
|---|---|
| 4 | Невалидные входные параметры (например, timeFrom > timeTo или отсутствуют обязательные поля). |
| 5 | Ошибка выполнения запроса. |
| 7 | Доступ запрещен. Отсутствуют необходимые права доступа на объекты или услуга Задачи не включена или не активирована. |
| 1004 | Превышено максимальное количество сообщений (параметр loadCount). |