API системы мониторинга:
обмен данными с учётными системами предприятия
Программный интерфейс позволяет передавать данные мониторинга в системы, которыми уже пользуется предприятие: учётную программу, логистический модуль, мобильное приложение или собственную разработку. Диспетчер работает в привычном интерфейсе, а сведения о машинах попадают туда автоматически, без ручного ввода. Например, стоимость доставки рассчитывается по фактическому пробегу, а акты выполненных работ формируются автоматически.
- текущее местоположение и статус транспортных средств;
- история движения и треки за выбранный период;
- события: заправки, сливы, простои, превышения скорости;
- пробег и наработка для планирования обслуживания;
- готовые отчёты в обмен на запрос внешней системы;
- программное управление объектами по команде внешней системы.
Что такое программный интерфейс мониторинга
API — это набор методов и правил, по которым внешние программы обращаются к системе мониторинга. Внешнее приложение не получает доступ к внутренней логике сервиса: оно запрашивает конкретные данные и получает их в структурированном виде. Это сохраняет безопасность и стабильность работы платформы.
Запросы передаются по защищённому каналу, доступ подтверждается ключом или учётными данными приложения. Ответ формируется в формате JSON — он одинаково хорошо читается и серверными системами, и мобильными приложениями.
Что входит в услугу
Доступ к API
Ключ доступа и подключение к данным вашего автопарка с разграничением прав.
Консультации по интеграции
Помощь специалистов на этапе проектирования и подключения к вашим системам.
Разработка модулей
Индивидуальные модули и приложения на основе данных мониторинга.
Документация
Описание методов, параметров, лимитов и примеров запросов и ответов.
Обновления и поддержка
Развитие функциональности и техническая поддержка разработчиков.
Безопасность
Передача данных по HTTPS, авторизация по ключу и контроль доступа.
Какие данные доступны
| Местоположение | Текущие координаты, скорость, направление движения и время последнего определения |
|---|---|
| Треки | История движения за произвольный период с разделением по рейсам и стоянкам |
| События | Заправки и сливы топлива, простои, превышения скорости, вход и выход из геозон |
| Пробег и наработка | Показания одометра, моточасы, данные для планирования техобслуживания |
| Датчики | Уровень топлива, температура, состояние дискретных входов и навесного оборудования |
| Справочники | Список объектов, водителей, прицепов и закреплённых датчиков |
| Управление | Передача команд на оборудование: блокировка двигателя, управление внешними устройствами — в зависимости от модели трекера |
Как проходит интеграция
- Внешнее приложение отправляет запрос с указанием нужного ресурса и периода.
- Сервер проверяет права доступа и корректность параметров запроса.
- При успешной авторизации возвращаются структурированные данные в формате JSON.
- Внешняя система обрабатывает ответ: отображает данные на карте, сохраняет в базе или использует в расчётах.
Для регулярного обмена настраиваются периодические запросы или подписка на события: система сама уведомляет внешний сервис, когда происходит заправка, слив или выход из геозоны.
Как подключиться к API
- Заявка. Свяжитесь с нами, опишите задачу и состав систем, с которыми планируется интеграция.
- Ключ доступа. Мы выдаём ключ и настраиваем права на доступ к данным вашего автопарка.
- Документация. Вы получаете описание методов, параметров, лимитов и примеров запросов и ответов.
- Разработка и тестирование. Интеграция выполняется на тестовом доступе, затем — на рабочих данных.
- Поддержка и развитие. Сопровождаем интеграцию и подключаем новые методы по мере развития API.
Технические детали
API построен на REST-архитектуре и возвращает данные в формате JSON, поэтому совместим с современными языками программирования и платформами. Соединение защищено протоколом HTTPS, авторизация выполняется по ключу с разграничением прав и возможностью отзыва доступа.
- запросы к текущему состоянию объектов и истории за произвольный период;
- получение данных стандартных и настраиваемых отчётов;
- вебхуки для мгновенных уведомлений о событиях: слив топлива, вход в запретную зону, превышение скорости;
- передача команд на оборудование, если это поддерживает модель трекера.
Типовые сценарии: автоматическая выгрузка данных о расходе ГСМ в 1С, интеграция с CRM для контроля визитов мобильных сотрудников, клиентские приложения для отслеживания заказов, расчёт стоимости доставки по фактическому пробегу.
Типовые сценарии использования
Логистика и доставка
Фактическое время прибытия подставляется в заявку автоматически, задержки и отклонения от маршрута видны в логистическом модуле.
Бухгалтерия и учёт ГСМ
Данные о пробеге и расходе топлива попадают в учётную систему: списание ГСМ выполняется по фактическим показателям.
Мобильные приложения
Руководитель или менеджер видит рейсы и состояние транспорта в собственном приложении предприятия.
Техническое обслуживание
Пробег и моточасы передаются в систему ТО, и заявка на ремонт формируется по фактической наработке.
Что даёт интеграция
- Меньше ручного труда. Данные вводятся один раз — на объекте, а дальше передаются автоматически.
- Меньше ошибок. Исключаются опечатки при переносе пробега и путевых листов.
- Единое информационное пространство. Мониторинг становится частью общей системы управления предприятием.
- Масштабируемость. При росте автопарка обмен данными не требует перестройки процессов.
- Прозрачность. Показатели мониторинга доступны всем подразделениям, которым они нужны.
Читайте также
- Интеграция мониторинга с 1С — передача данных в учётную систему.
- Веб-интерфейс мониторинга — работа диспетчера в браузере.
- Веб-интерфейс для клиентов — личный кабинет для доступа к данным.
- Купить систему мониторинга — состав комплекта и внедрение.
- Стоимость системы мониторинга — тарифы и оборудование.
Частые вопросы об интеграции
Для чего нужен API системы мониторинга?
Он даёт программный доступ к данным автопарка — местоположению, телеметрии, отчётам — и позволяет встраивать их в учётные, логистические и клиентские системы, чтобы автоматизировать сбор и обработку показателей.
Какие данные можно получить через API?
Текущие координаты и скорость, направление движения, показания датчиков (топливо, температура, работа механизмов), историю перемещений и агрегированные данные отчётов.
Можно ли управлять устройствами через API?
В зависимости от типа оборудования и ваших задач интерфейс позволяет отправлять команды на трекер, например блокировку двигателя или управление внешними устройствами.
В каком формате передаются данные?
Ответы формируются в формате JSON. Такой формат одинаково удобно обрабатывается серверными системами, веб-приложениями и мобильными клиентами.
Нужны ли программисты на стороне заказчика?
Для типовых интеграций — с учётной программой или логистическим модулем — доработка не требуется. Если нужен собственный сценарий обмена, потребуется участие разработчика заказчика или наших специалистов.
Как защищён доступ к данным?
Запросы выполняются по защищённому каналу, доступ подтверждается ключом или учётными данными приложения. Внешняя система видит только те объекты, к которым ей разрешён доступ.
Можно ли получать уведомления о событиях?
Да. Помимо запросов по расписанию настраивается подписка: система сама сообщает внешнему сервису о заправке, сливе, выходе из геозоны или простое.