messages_requests_examples
Работать с сообщениями можно с помощью загрузчика сообщений. Для этого необходимо загрузить их туда с помощью одной из двух команд: messages/load_last или messages/load_interval. Если затем вы хотите загрузить другие сообщения, то сначала необходимо очистить загрузчик с помощью команды messages/unload.
Загрузка сообщений
Загрузим позиционные сообщения с данными за интервал с 01.04.2013 по 20.04.2013 с помощью запроса messages/load_interval и получим первые три сообщения. Чтобы запросить только позиционные сообщения с данными, используйте маску 0xFF01 (65281). Маска 0xFF00 (65280) определяет тип сообщения, 0x0001 (1) — наличие в сообщениях информации о местоположении. Также необходимо использовать флаг 0x0001 (1), который является суммой флага 0x0000 (0) для сообщений с данными и флага 0x0001 (1) для позиционных сообщений.
https://hst-api.wialon.com/wialon/ajax.html?svc=messages/load_interval&
params={
"itemId":34868,
"timeFrom":1364760000,
"timeTo":1366487999,
"flags":1,
"flagsMask":65281,
"loadCount":3
}&sid=<your_sid>
Ответ:
{
"count": 9172,
"messages": [{
"t": 1364760081,
"f": 3,
"tp": "ud",
"pos": {
"y": 53.8396544,
"x": 27.5608672,
"z": 213,
"s": 0,
"c": 51,
"sc": 9
},
"i": 0,
"p": {
"param22": 3,
"adc1": 12.606,
"pwr_ext": 12.598,
"param199": 0,
"param241": 25701,
"battery_charge": 0
}
}, {
"t": 1364760381,
"f": 3,
"tp": "ud",
"pos": {
"y": 53.8396544,
"x": 27.5609312,
"z": 213,
"s": 0,
"c": 73,
"sc": 9
},
"i": 0,
"p": {
"param22": 3,
"adc1": 12.545,
"pwr_ext": 12.547,
"param199": 0,
"param241": 25701,
"battery_charge": 0
}
}, {
"t": 1364760682,
"f": 3,
"tp": "ud",
"pos": {
"y": 53.8396736,
"x": 27.5609664,
"z": 215,
"s": 0,
"c": 64,
"sc": 9
},
"i": 0,
"p": {
"param22": 3,
"adc1": 12.6,
"pwr_ext": 12.569,
"param199": 0,
"param241": 25701,
"battery_charge": 0
}
}]
}
После загрузки вы можете выбрать любое количество сообщений для дальнейшей обработки. Например, выберем девятое сообщение из загрузчика. Для этого воспользуемся запросом messages/get_messages:
https://hst-api.wialon.com/wialon/ajax.html?svc=messages/get_messages&
params={
"indexFrom":8,
"indexTo":9
}&sid=<your_sid>
Ответ:
[{
"t": 1364762485,
"f": 3,
"tp": "ud",
"pos": {
"y": 53.8396992,
"x": 27.5609216,
"z": 223,
"s": 0,
"c": 45,
"sc": 7
},
"i": 0,
"p": {
"param22": 3,
"adc1": 12.584,
"pwr_ext": 12.569,
"param199": 0,
"param241": 25701,
"battery_charge": 0
}
}]
Удаление сообщений
Удалим первое сообщение, используя запрос messages/delete_message:
https://hst-api.wialon.com/wialon/ajax.html?svc=messages/delete_message&
params={
"msgIndex":0
}&sid=<your_sid>
Ответ:
{ }
Очистка загрузчика сообщений
Если вы хотите загрузить сообщения за другой интервал или от другого объекта, сначала очистите загрузчик сообщений:
https://hst-api.wialon.com/wialon/ajax.html?svc=messages/unload¶ms={}&sid=<your_sid>
Ответ:
{ }