События ТС
Получение всех событий
GET /events/last
Структура запроса:
GET /events/last?token=bw3ty3h46yth
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
[{
"id": 29041304,
"dataFrom": 1389361046000,
"dataTill": 1389361188000,
"info": " ",
"data": "6547",
"gaugeInfo": null,
"gaugeId": null,
"glonassId": 42117,
"carId": 111447,
"eventId": 1,
"notifiable": true,
"carNo": "С001СЕ",
"carName": "CHEVROLET"
},...]Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Получение события по ID
GET /events/{id}
Структура запроса:
GET /events/29041304?token=bw3ty3h46yth
id: id события
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"id": 29041304,
"dataFrom": 1389361046000,
"dataTill": 1389361188000,
"lat": 55.7876,
"lon": 49.1406,
"description": "Остановка (00:02:22)"
}
// id события, целое число
// время начала действия события, timestamp
// время конца действия события, timestamp
// широта, число с плавающей точкой
// долгота, число с плавающей точкой
// описание события, строка
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Получение новых событий
Для подписки на обновление информации о событиях конкретных ТС необходимо отправить WebSocket-сообщение «SET_OBSERVABLE_CARS», содержащее массив glonassID данных ТС. Новые события приходят в сообщении вебсокета с заголовком EVENT_UPDATES.
Структура запроса:
Формат: json
{
"command": "SET_OBSERVABLE_CARS",
"data": [3333,107285,107305,107328]
}
// заголовок сообщения, строка
// glonassId ТС, на которые подписываемся
Ответ:
Формат: json
{
"command": "EVENT_UPDATES",
"data": [
{
"carId": 1869,
"carName": "ПАЗ-115",
"carNo": "ВН115 16 RUS",
"dataFrom": 1390224122000,
"dataTill": 1390226705000,
"eventId": 1,
"gaugeInfo": null,
"glonassId": 223789,
"id": 44672821,
"info": ""
}
]
}
// заголовок сообщения, строка
// id ТС, целое число
// название ТС, строка
// номер ТС, строка
// начало действия события, timestamp
// конец действия события, timestamp
// тип события(см. ниже), целое число
// информация о датчике, строка
// ГЛОНАСС id, целое число
// id события, целое число
// если событие датчика, то тип датчика, строка
Типы событий
GET /events/types
Структура запроса:
GET /events/types?token=bw3ty3h46yth
token: ключ доступа
Ответ:
Формат: json
[{
"id": 1,
"name": "parking",
"defaultMessage": "ТС car.carInfo.carNo остановилось в date",
"title": "Остановка",
"iconList": "/assets/images/icons/parking.png",
"iconMap": "/assets/images/markers/parking.png",
"view": true,
"isModul": false,
"notifiable": true
},...]
// id типа события, целое число
// название события, строка
// сообщение по умолчанию, строка
// заголовок, строка
// иконка списка, строка
// иконка карты, строка
// является видимым, булевое поле
// является модулем, булевое поле
// посылает оповещения, булевое поле
Типы событий:
1 — остановка
2 — потеря сигнала
3 — поворот
4 — поломка оборудования
5 — смена скоростного режима
6 — вход в геозону
7 — выход из геозоны
8 — событие цифрового датчика (если тип датчика 32, то событие 8 — это зажигание)
9 — событие аналогового датчика
10 — заправка топлива
11 — слив топлива
12 — зажигание сработало без назначенного водителя
13 — прибыл в контрольную точку
14 — прибыл к месту заявки
15 — зажигание
16 — выход на маршрут
17 — уход с маршрута
18 — задание назначено
19 — задание выполнено
20 — задание просрочено
21 — задание отменено водителем
22 — задание принято водителем
23 — задание отменено диспетчером
24 — ТС ушло с маршрута
25 — долгая остановка ТС на маршруте