Здесь показаны различия между двумя версиями данной страницы.
Both sides previous revision Предыдущая версия Следущая версия | Предыдущая версия Следущая версия Both sides next revision | ||
ru:sidebar:remoteapi:apiref:messages:get_messages [17/03/2015 13:10] mast |
ru:sidebar:remoteapi:apiref:messages:get_messages [17/03/2015 16:01] mast |
||
---|---|---|---|
Строка 3: | Строка 3: | ||
<code javascript> | <code javascript> | ||
svc=messages/get_messages¶ms={"indexFrom":<uint>, | svc=messages/get_messages¶ms={"indexFrom":<uint>, | ||
- | "indexTo":<uint> | + | "indexTo":<uint>, |
"timeFrom:"<uint>, | "timeFrom:"<uint>, | ||
"timeTo":<uint>, | "timeTo":<uint>, | ||
+ | "filter":<text>, | ||
+ | "flags":<uint>, | ||
+ | "flagsMask":<uint>, | ||
"loadCount":<uint>} | "loadCount":<uint>} | ||
</code> | </code> | ||
Строка 17: | Строка 20: | ||
| timeFrom | начало интервала | | | timeFrom | начало интервала | | ||
| timeTo | окончание интервала | | | timeTo | окончание интервала | | ||
+ | | filter | фильтр, поиск по "pos" и "p"| | ||
+ | | flags | флаги [[./load_interval|(см.здесь)]] | | ||
+ | | flagsMask | маска [[./load_interval|(см.здесь)]] | | ||
| loadCount | количество сообщений, которое будет возвращено (0xffffffff - все найденные) | | | loadCount | количество сообщений, которое будет возвращено (0xffffffff - все найденные) | | ||
:!: Логика метода расширена: вы можете пользоваться как старой версией **indexFrom/indexTo**, так и новыми:\\ | :!: Логика метода расширена: вы можете пользоваться как старой версией **indexFrom/indexTo**, так и новыми:\\ | ||
- **timeFrom/timeTo** (определяем время начала и время конца сообщений);\\ | - **timeFrom/timeTo** (определяем время начала и время конца сообщений);\\ | ||
- **timeFrom/loadCount** (определяем время начала сообщений, выведет loadCount последних сообщений);\\ | - **timeFrom/loadCount** (определяем время начала сообщений, выведет loadCount последних сообщений);\\ | ||
- | - **timeTo/loadCount** (определяем время окончания сообщений, выведет loadCount последних сообщений). | + | - **timeTo/loadCount** (определяем время окончания сообщений, выведет loadCount последних сообщений).\\ |
+ | К любому варианту логики применим фильтр "filter". Поиск осуществляется по "pos" и "p" параметрам. Даже если в полученных сообщениях нет указанных параметров, минимальная базовая информация всё равно предоставляется ("t","f","tp","i","o"). | ||
+ | |||
+ | Пример ответа: | ||
+ | <code javascript> | ||
+ | { | ||
+ | "count": 1, | ||
+ | "messages": [{ | ||
+ | "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 | ||
+ | } | ||
+ | }] | ||
+ | } | ||
+ | </code> | ||
+ | Пример поиска: | ||
+ | <code javascript> | ||
+ | "filter":"pos.x,p.pre*,p.param?" | ||
+ | </code> | ||
+ | |||
+ | Результат после наложения фильтра: | ||
+ | <code javascript> | ||
+ | { | ||
+ | "count": 1, | ||
+ | "messages": [{ | ||
+ | "t": 1426233861, | ||
+ | "f": 7, | ||
+ | "tp": "ud", | ||
+ | "pos": { | ||
+ | "x": 27.4470783333 | ||
+ | }, | ||
+ | "i": 0, | ||
+ | "o": 0, | ||
+ | "p": { | ||
+ | "pre2": 123, | ||
+ | "param5": 43 | ||
+ | } | ||
+ | }] | ||
+ | } | ||
+ | </code> | ||
+ | На выходе увидим значения pos.x, значения параметров в объекте pos, начинающихся с "pre", значения параметров в объекте pos, начинающихся с "param" и имеющих ещё один символ в конце (к примеру param1, но param не подойдёт). | ||
+ | Число точных параметром через запятую неограничено. * -- замена 0 или более символов, ? - замена одного символа. | ||
===== Возвращаемый результат ===== | ===== Возвращаемый результат ===== | ||
<code javascript> | <code javascript> | ||
- | [ /* массив сообщений */ | + | { |
- | { | + | "count": <uint>, |
- | ... | + | "messages": [ /* массив сообщений */ |
- | } | + | { ... }, /* сообщение */ |
- | ] | + | { ... } /* сообщение */ |
+ | ] | ||
+ | } | ||
</code> | </code> | ||
Форматы сообщений рассмотрены в разделе [[../format/messages | Форматы данных: Сообщения]]. | Форматы сообщений рассмотрены в разделе [[../format/messages | Форматы данных: Сообщения]]. | ||
|