У GisNavi есть REST API для интеграций: список устройств, треки, отчёты и команды. Он подходит, если нужно передавать данные в свою систему, 1С или BI.
Адрес и документация
| Что | Адрес |
|---|---|
| Базовый адрес API | http://api.gisnavi.ru:9185 |
| Swagger UI | api.gisnavi.ru:9185/swagger-ui |
| OpenAPI (JSON) | /v3/api-docs |
Токен
Токен выдаёт техническая поддержка: support@gisnavi.ru. Он передаётся в каждом запросе параметром session:
curl "http://api.gisnavi.ru:9185/api/device/all?session=ВАШ_ТОКЕН"API работает по HTTP, а токен передаётся в адресе запроса. Используйте доверенную сеть или VPN, не публикуйте токен в репозиториях и логах, при утечке запросите новый.
Формат ответа
Ответы — JSON. При ошибке в параметрах сервер вернёт 400 и JSON с полями status, error, path. Если токен неверный или доступ не выдан, методы могут вернуть пустой результат — проверьте токен и права.
Методы
| Метод | Что делает |
|---|---|
GET /api/device/all | Список устройств по токену |
GET /api/device/{IMEI} | Информация по устройству |
GET /api/device/{IMEI}/track | Архив точек и отрезков за период |
GET /api/device/{IMEI}/stat-short | Краткая статистика: пробег, скорости, стоянки |
GET /api/device/{IMEI}/parking | Стоянки дольше 5 минут |
GET /api/device/{IMEI}/stopplaces | Остановки короче 5 минут |
GET /api/device/{IMEI}/sendInputOnOFF | Включить или выключить вход |
GET /api/device/{IMEI}/sendCustomCommand | Произвольная команда на терминал |
Правила интеграции
- не делайте частых параллельных запросов — кэшируйте справочники;
- даты передавайте в формате метода (см. следующие статьи);
- команды на устройство отправляйте только после теста на безопасном объекте.
Дальше: устройства и треки · отчёты и команды.