get_messages

To get messages from the message loader, use the messages/get_messages method. Before that, load messages into the session with messages/load_interval.

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

For an example of this request, see Message request examples.

The parameters are optional.

The method logic is extended: you can use both the old indexFrom/indexTo logic and the new ones:

Important. To use this method, the request should contain at least one of the parameter pairs from above.

In this method, the flags and flagsMask parameters work differently than in messages/load_interval: they exclude messages from the response instead of selecting them. A message isn’t returned if flags isn’t 0 and the bitwise AND of the message flags (f) and flags equals flagsMask. If flags is 0, no messages are excluded.

For the message flags, see Messages.

The filter option can be used for any logic. The search is available in the pos and p parameters. The filter doesn’t affect other message fields (for example, t, f, tp, i, o): they’re always returned. If no parameters of the pos object match the filter, pos is returned as an empty object.

Response example (no filtering):

[
    {
	"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
	}
    }
]

Filter example:

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

Filtered response:

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

After filtering we see the pos.x value, the values of the parameters in the p object which begin with pre, and the values of the parameters in the p object which begin with param and have one more symbol at the end (for example, param1 is valid, but param is invalid for search).
The number of defined parameters separated by a comma is unlimited. The asterisk (*) is used as a wildcard for 0 or more symbols, and the question mark (?) as a wildcard for one symbol.

[	/* message array */
	{ ... },	/* message */
	{ ... }		/* message */
]

For message formats, see Messages.