load_last
Para cargar los últimos mensajes correspondientes a un momento determinado, utilice el método messages/load_last.
Endpoint
svc=messages/load_last¶ms={"itemId":<long>,
"lastTime":<uint>,
"lastCount":<uint>,
"flags":<uint>,
"flagsMask":<uint>,
"loadCount":<uint>}
Parámetros
Los parámetros obligatorios están marcados con un asterisco (*).
| Parámetro | Descripción |
|---|---|
itemId* |
ID de la unidad o del recurso (depende del tipo de mensaje que quiera obtener). |
lastTime* |
Hora para la cual se solicitan los mensajes. |
lastCount* |
Cantidad de mensajes que se deben cargar. |
flags* |
Flags de mensajes. Se usan para cargar solo los mensajes con los flags especificados. Consulte Mensajes. |
flagsMask* |
Máscara. Ver load_interval. |
loadCount* |
Cantidad de mensajes a devolver. |
Para cargar los mensajes del historial de la unidad (el flag 0x1000), el usuario necesita el derecho de acceso Gestionar registros del objeto a la unidad. Sin este derecho, los mensajes del historial no se devuelven y no se produce ningún error.
Respuesta
Si la solicitud se ejecuta correctamente, se devuelve el siguiente resultado:
{
"count":<uint>, /* cantidad de mensajes */
"messages":[ /* matriz de mensajes */
{
...
}
]
}
Para ver los formatos de mensajes, consulte Mensajes.
Si la solicitud no se ejecuta correctamente, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos, o el valor de lastCount es menor que 1 o mayor que 10000. |
| 6 | No se pudieron obtener los mensajes de la unidad. |
| 7 | La unidad no existe o el usuario no tiene el derecho de acceso Solicitar informes y mensajes a ella. |