get_messages

Para obtener mensajes del cargador de mensajes, utilice el método messages/get_messages. Antes, cargue los mensajes en la sesión con messages/load_interval.

svc=messages/get_messages&params={
  "indexFrom": <uint>,
  "indexTo": <uint>,
  "timeFrom": <uint>,
  "timeTo": <uint>,
  "filter": "<text>",
  "flags": <uint>,
  "flagsMask": <uint>,
  "loadCount": <uint>
}

Para ver un ejemplo de esta solicitud, consulte Ejemplos de solicitudes de mensajes.

Los parámetros son opcionales.

La lógica del método está ampliada: puede usar tanto la lógica anterior de indexFrom/indexTo como la nueva:

Importante. Para usar este método, la solicitud debe contener al menos uno de los pares de parámetros mencionados arriba.

En este método, los parámetros flags y flagsMask funcionan de forma distinta que en messages/load_interval: excluyen mensajes de la respuesta en lugar de seleccionarlos. Un mensaje no se devuelve si flags no es 0 y el resultado de la operación AND bit a bit entre los flags del mensaje (f) y flags es igual a flagsMask. Si flags es 0, no se excluye ningún mensaje.

Para ver los flags de los mensajes, consulte Mensajes.

La opción filter se puede usar con cualquier lógica. La búsqueda está disponible en los parámetros pos y p. El filtro no afecta a los demás campos del mensaje (por ejemplo, t, f, tp, i, o): siempre se devuelven. Si ningún parámetro del objeto pos coincide con el filtro, pos se devuelve como un objeto vacío.

Ejemplo de respuesta (sin filtrado):

[
    {
	"t": 1426233861,
	"f": 7,
	"tp": "ud",
	"pos": {
		"y": 53.84541,
		"x": 27.4470783333,
		"z": 0,
		"s": 25,
		"c": 285,
		"sc": 255
		},
	"i": 0,
	"o": 0,
	"p": {
		"adc1": 0,
		"pre2": 123,
		"param": 24,
		"param5": 43
	}
    }
]

Ejemplo de filtro:

"filter":"pos.x,p.pre*,p.param?"

Respuesta filtrada:

[
       {
		"t": 1426233861,
		"f": 7,
		"tp": "ud",
		"pos": {
			"x": 27.4470783333
			},
		"i": 0,
		"o": 0,
		"p": {
			"pre2": 123,
			"param5": 43
		}
	}
]

Después del filtrado vemos el valor de pos.x, los valores de los parámetros del objeto p que comienzan con pre y los valores de los parámetros del objeto p que comienzan con param y tienen un símbolo más al final (por ejemplo, param1 es válido, pero param no es válido para la búsqueda).
La cantidad de parámetros definidos, separados por coma, es ilimitada. El asterisco (*) se usa como comodín para 0 o más símbolos, y el signo de interrogación (?) como comodín para un símbolo.

[	/* matriz de mensajes */
	{ ... },	/* mensaje */
	{ ... }		/* mensaje */
]

Para ver los formatos de mensajes, consulte Mensajes.