Вы находитесь здесь: Gurtam » Wialon Developers » Wialon Hosting » Remote API » API Документация » Сообщения » Получить сообщения

Содержание

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

--- ru:sidebar:remoteapi:apiref:messages:get_messages [17/03/2015 13:10]
mast
+++ ru:sidebar:remoteapi:apiref:messages:get_messages [17/03/2015 17:01]
127.0.0.1 внешнее изменение
@@ Строка 3: / Строка 3: @@
 <code javascript>
 svc=messages/get_messages&params={"indexFrom":<uint>,
-				  "indexTo":<uint>
+				  "indexTo":<uint>,
 				  "timeFrom:"<uint>,
 				  "timeTo":<uint>,
+				  "filter":<text>,
+				  "flags":<uint>,
+				  "flagsMask":<uint>,
 				  "loadCount":<uint>}
 </code>
@@ Строка 17: / Строка 20: @@
 | timeFrom | начало интервала |
 | timeTo | окончание интервала |
+| filter | фильтр, поиск по "pos" и "p"|
+| flags | флаги [[./load_interval|(см.здесь)]] |
+| flagsMask | маска [[./load_interval|(см.здесь)]] |
 | loadCount | количество сообщений, которое будет возвращено (0xffffffff - все найденные) |
 :!: Логика метода расширена: вы можете пользоваться как старой версией **indexFrom/indexTo**, так и новыми:\\
 - **timeFrom/timeTo** (определяем время начала и время конца сообщений);\\
 - **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>
-[			/* массив сообщений */
+{
-	{
+	"count": <uint>,
-		...
+	"messages": [		/* массив сообщений */
-	}
+		{ ... },	/* сообщение */
-]
+		{ ... }		/* сообщение */
+	]
+}
 </code>
 Форматы сообщений рассмотрены в разделе [[../format/messages | Форматы данных: Сообщения]].