get_task_messages

Para cargar mensajes de asuntos para unidades, utilice el método messages/get_task_messages.

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

Copied!

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

Ejemplo de solicitud

Copied!

https://hst-api.wialon.com/wialon/ajax.html?sid=IDENTIFICADOR_DE_SESION&svc=messages/get_task_messages&params={
        "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.

Copied!

{
    "count": 1,
    "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": {}
            }
        }
    ]
}

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`).