get_task_messages
Para cargar mensajes de asuntos para unidades, utilice el método messages/get_task_messages.
En Wialon Local, este método está disponible a partir de la versión 2504.
Para obtener mensajes de asuntos, necesita los derechos de acceso Ver objeto y sus propiedades básicas y Solicitar informes y mensajes a las unidades. El servicio Asuntos debe estar habilitado y activo para la cuenta.
Endpoint
svc=messages/get_task_messages¶ms={
"itemIds": [<long>],
"timeFrom":<uint>,
"timeTo":<uint>,
"loadCount":<uint>
}
Ejemplo de solicitud
https://hst-api.wialon.com/wialon/ajax.html?sid=IDENTIFICADOR_DE_SESION&svc=messages/get_task_messages¶ms={
"itemIds":[1546, 1545],
"timeFrom": 1724347800,
"timeTo": 1724693399,
"loadCount": 10000
}
Parámetros
Los siguientes parámetros son obligatorios:
| Parámetro | Descripción |
|---|---|
itemIds |
Matriz de identificadores de unidades para las cuales se solicitan mensajes de asuntos. |
timeFrom |
Inicio del intervalo de tiempo (hora Unix, UTC). |
timeTo |
Final del intervalo de tiempo (hora Unix, UTC). Debe ser mayor o igual a timeFrom. |
loadCount |
Cantidad de mensajes a devolver. El número máximo es 20000. |
Respuesta
Si la solicitud se completa correctamente, la respuesta contiene la cantidad de mensajes de asuntos y la matriz de mensajes. Cada mensaje contiene el ID de la unidad (item_id), la hora del mensaje (t), los flags del mensaje (f, siempre 20480 para los asuntos) y los parámetros del asunto (p). Los mensajes se ordenan por hora, del más antiguo al más reciente. Si la cantidad de mensajes encontrados es mayor que loadCount, solo se devuelven los más recientes.
{
"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
}
}
}
]
}
La descripción de los parámetros del asunto y los valores de task_reg_type, task_status y task_priority se indican en la sección Asunto. Los valores de task_sub_type se indican en la sección Subtipos de eventos y asuntos.
Si la solicitud no se completa, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada no válidos (por ejemplo, timeFrom > timeTo o faltan campos obligatorios). |
| 5 | Error al ejecutar la solicitud. |
| 7 | Acceso denegado. No tiene los derechos de acceso necesarios a las unidades o el servicio Asuntos no está habilitado o activo. |
| 1004 | Se excedió la cantidad máxima de mensajes (parámetro loadCount). |