Список API серверов компании — руководство пользователя
«Список API серверов компании» — это справочник подключений к внешним платформам мониторинга (Wialon, FortMonitor, Omnicomm и другим). Он нужен, когда транспорт компании уже стоит на учёте не в Exzotron, а у другого оператора мониторинга, и данные (координаты, датчики, RFID-метки) нужно забирать оттуда через их собственный API — вместо того чтобы переставлять терминалы на протокол Exzotron.
Раздел находится в «Администратор» → «Сервисные Функции» → «Список API серверов компании». Просмотр доступен ролям Администратор, Продвинутый пользователь и Пользователь; добавление, редактирование, удаление, проверка соединения и синхронизация объектов/RFID-меток — только Администратору и Продвинутому пользователю.
1. Структура таблицы#
| № | Элемент | Описание |
|---|---|---|
| 1 | Имя | Внутреннее название сервера в Exzotron (произвольное, для удобства); должно быть уникальным в рамках компании. |
| 2 | Адрес | Адрес внешней платформы. Если ввести без «http»/«https» — система сама подставит «https://». |
| 3 | Тип | Платформа мониторинга — выбирается из справочника (раздел 3). |
| 4 | Порт | Сохраняется в настройках, но ни в одном реальном запросе к внешнему API не используется — адрес запроса формируется без порта. |
| 5 | Логин | Логин на внешней платформе. |
| 6 | Пароль | Пароль на внешней платформе; в списке всегда показывается как «***». |
| 7 | Токен | Заполняется по-разному в зависимости от типа: где-то это готовый токен доступа, который нужно ввести вручную (Wialon, Гелиос), где-то — поле, которое система сама заполнит после успешной авторизации по логину/паролю. |
| 8 | ID Компании API | Идентификатор компании/схемы на стороне внешней платформы; для большинства типов подставляется автоматически при первой успешной проверке соединения, если оставить поле пустым. |
| 9 | Пояс | Смещение часового пояса (UTC), например «3» = UTC+3. Используется по-разному в зависимости от типа (раздел 3). |
| 10 | Дата синхронизации | Не «когда последний раз успешно забрали данные», а точка отсчёта, с которой должна идти синхронизация — подробнее в разделе 6. Двойной клик открывает поле для изменения. |
| 11 | Расчет факта | Чекбокс, доступный только для типа FortMonitor. Функционал выводится из эксплуатации — для новых серверов его использовать не нужно; актуальный способ получить данные с внешней платформы — синхронизация объектов и меток, описанная в разделе 5. |
| 12 | Активна | Отдельный чекбокс включения/выключения записи без её удаления. |
| 13 | Проверка соединения | Запускает тестовый запрос к серверу. Значок меняется по результату: крутящаяся стрелка — тест не запускался/идёт; зелёная галочка — соединение успешно; красный крестик — ошибка. |
| 14 | Избранное | Заполненная звёздочка отмечает, какой из серверов компании является «текущим» — это просто индикатор, отдельного клика для его смены в этом столбце нет. |
| 15 | Редактировать | Переводит строку в режим редактирования (поля становятся доступны для правки, справа появляются кнопки «Сохранить»/«Отмена»). |
| 16 | Удалить | Удаляет запись сервера целиком (без подтверждения). |
2. Типы серверов#
Ниже — все 10 типов и по каждому: пример адреса, который реально чаще всего указывают в базе компаний, и как именно этот тип использует поля логина/пароля/токена.
| Тип | Частый пример адреса | Как проходит подключение |
|---|---|---|
| Wialon | https://hst-api.regwialon.ru/ |
Логин/пароль в форме обязательны для первой авторизации, но реально система входит по токену Wialon (тот же, что и в личном кабинете Wialon). «Пояс» здесь — сдвиг времени точек датчика при построении графиков. |
| FortMonitor | https://web.fort-monitor.ru |
Логин, пароль и «Пояс» передаются прямо в запросе авторизации. У этого типа есть чекбокс «Расчет факта» (пункт 11 в разделе 1), но связанный с ним функционал автоматической фоновой синхронизации выводится из эксплуатации — данные с FortMonitor, как и с любой другой платформы, нужно получать синхронизацией объектов, см. раздел 5. |
| Omnicomm | https://online.omnicomm.ru |
Логин/пароль → система сама получает и хранит токен доступа. |
| AG | https://agweb.antey-gk.ru |
Логин/пароль → сессия; «ID Компании API» — это идентификатор схемы данных на сервере AG. |
| ASK | — | На момент подготовки руководства ни одна компания в базе не использует этот тип, живого примера адреса нет. |
| ГЛОНАССсофт | https://hosting.glonasssoft.ru |
Логин/пароль → система сама получает служебный заголовок авторизации. |
| Гелиос | https://api.geliospro.com |
Отличается от остальных: в поле «Токен» нужно сразу вписать готовый токен доступа, а поле «Пароль» используется не как обычный пароль, а как токен обновления (refresh-токен), когда основной токен истекает. |
| Glosav | http://glosav2.glosav.ru/autosatv2/wservices/cxfRepl?WSDL |
Логин/пароль используются прямо в каждом запросе, отдельного токена нет. |
| CarvisVideo | http://ct.navexp.ru/ |
Видеомониторинг; логин/пароль по общей схеме. |
| Axenta | https://axenta.cloud/ |
Логин/пароль → система сама получает токен доступа. |
Поле «Порт» никак не участвует в фактическом запросе к внешнему серверу ни для одного из типов — реальный адрес строится из поля «Адрес» без порта. Указывать порт можно для собственной справки, на подключение это не влияет.
3. Добавление нового сервера#
Нижняя пустая строка таблицы — форма добавления. Кнопка «+» становится активной, как только заполнены хотя бы «Имя» и «Адрес» — остальные поля на уровне формы не обязательны (ошибка появится только при реальной попытке подключиться, если данных не хватит).
| № | Элемент | Описание |
|---|---|---|
| 1 | Имя | Обязательное поле. |
| 2 | Адрес | Обязательное поле. |
| 3 | Тип | От выбранного типа зависит, появится ли доступным чекбокс «Расчет факта» (пункт 11) — но включать его не нужно, см. примечание ниже. |
| 4 | Порт | По умолчанию 80. |
| 5 | Логин | — |
| 6 | Пароль | — |
| 7 | Токен | Оставить пустым, если тип получает токен сам после подключения. |
| 8 | ID Компании API | Можно оставить пустым — подставится автоматически. |
| 9 | Пояс | По умолчанию 3 (UTC+3). |
| 10 | Дата синхронизации | По умолчанию — текущее время. |
| 11 | Расчет факта | На скриншоте отмечен, потому что выбран тип FortMonitor — для любого другого типа поле остаётся серым и недоступным. Отмечать его не нужно: связанная с ним фоновая синхронизация выводится из эксплуатации (см. раздел 5). |
| 12 | «+» (Добавить) | Сохраняет новый сервер. Сразу после сохранения система автоматически выполняет проверку соединения — нажимать её отдельно не обязательно. |
4. Дата синхронизации — что это значит на самом деле#
Название колонки вводит в заблуждение: это не «когда в последний раз успешно забрали данные», а точка отсчёта, с которой должна идти (пере)синхронизация. Двойной клик по значению открывает поле ввода даты; после изменения система показывает сообщение «Изменена точка актуальности для пересчета. Пересчет запущен в фоне» и сбрасывает прогресс синхронизации, начиная забирать данные заново именно с указанной даты. Сколько уже реально синхронизировано по каждому автомобилю — отдельная внутренняя отметка, не выводится в этой таблице.
5. Синхронизация объектов и RFID-меток с внешнего сервера#
Автоматическая фоновая синхронизация по чекбоксу «Расчет факта» (только для FortMonitor) выводится из эксплуатации и здесь не описывается. Единственный актуальный способ получить объекты, метки и телеметрию с любой внешней платформы — ручная синхронизация из этого раздела, одинаковая для всех типов серверов.
Заполняются имя, адрес, тип, логин и пароль, нажимается «Проверка соединения»; при успехе появляется зелёный значок. Дальше нужно кликнуть по самой строке сервера в таблице (раздел 1) — справа откроется рабочая панель.
| № | Элемент | Описание |
|---|---|---|
| 1 | Переключатель «Объекты» | Показывает список техники, полученный с внешней платформы по её API (таблица с колонками ID, IMEI, «Есть»). Включён по умолчанию. |
| 2 | Переключатель «RFID» | Переключает панель на список RFID-меток/брелков с внешней платформы (колонки «Наименование», RFID, «Есть»). |
| 3 | «Выделить все» | Отмечает галочками сразу все строки списка — чтобы не кликать по каждой отдельно. |
| 4 | Кнопка синхронизации | Кнопка без надписи (только значок ✓) — запускает синхронизацию отмеченных строк. |
| 5 | Колонка «Есть» | Зелёная галочка — объект/метка уже синхронизированы и существуют в системе. Чекбокс для отметки строки показывается только у ещё не синхронизированных записей. |
Порядок действий: отметить нужные объекты или карты (или нажать «Выделить все») и нажать кнопку синхронизации — отмеченные записи получат галочку в столбце «Есть».
Сопоставление при синхронизации: автомобили сопоставляются с уже существующими объектами компании по IMEI (совпадение — обновляется привязка к серверу; совпадения нет — создаётся новый объект). RFID-метки сопоставляются по коду метки. Новые объекты и метки сами по себе не создаются — это происходит только в момент нажатия кнопки синхронизации.
6. Автомобиль появляется в справочнике «Автотранспорт»#
Синхронизированные объекты — это уже реальные записи справочника автомобилей: раздел «Автотранспорт» (Администратор → Сервисные функции → Автотранспорт). У новой записи сразу заполнены IMEI и — если синхронизировался и был сопоставлен — RFID; остальные реквизиты (гос./гаражный номер, тип техники и т.д.) можно дозаполнить вручную.
Если сразу после синхронизации открыть «Автотранспорт» в уже открытой вкладке — список может не обновиться сам. Перезагрузите страницу раздела, чтобы увидеть новые записи.
7. Остаток топлива — прямо в разделе «Автотранспорт»#
Проще всего проверить остаток топлива не на карте, а там же, где ведётся справочник машин: в разделе «Автотранспорт» (раздел 6) выделите строку нужного автомобиля — слева откроется панель с данными по этому автомобилю: адрес, зажигание, текущий остаток, текущая скорость, дата последнего пакета и координаты.
Значение «Текущий остаток» появляется, только если у объекта есть датчик уровня топлива и по нему уже прошла синхронизация телеметрии (раздел 5) — это последнее сохранённое показание, а не «живой» запрос к внешней платформе в момент открытия панели.
8. Привязка RFID-карты к автомобилю#
Чтобы конкретная топливная карта/чип воспринималась системой как «карта этого автомобиля» (в частности — для контроля того, что на машине активна только одна карта, и для учёта заправок в бак по этой карте), у карты в «Объектах доступа» должен быть тип «Автомобиль» со ссылкой на сам автомобиль. При синхронизации RFID-меток с внешнего сервера (раздел 5) система сохраняет саму метку, но не проставляет ей тип и связь с автомобилем автоматически — это нужно сделать одним из двух способов.
8.1. Вручную — по одной карте#
Есть два равнозначных места, где задаётся связка «карта ↔ автомобиль» — достаточно заполнить одно из них:
| В карточке автомобиля | Автотранспорт → редактирование автомобиля → блок «Идентификация» → поле «RFID»: вписать номер карты. |
|---|---|
| В карточке RFID-карты | Объекты доступа → редактирование карты → выбрать тип «Автомобиль» → блок «Привязки» → поле «Автомобиль»: выбрать нужный автомобиль из списка. |
Сама детекция заправки по датчику уровня топлива (то, что попадает в отчёты по расходу топлива и в «Поступление топлива в баки по автомобилю») строится по телеметрии, которую тянет API-сервер, и не требует RFID-метки вообще — а вот именно связку «эта карта = этот автомобиль» система понимает только через тип «Автомобиль» у карты.
8.2. Массово — документом «Журнал регистрации карт»#
Если карт и автомобилей много, вручную по одной карте — медленно. Для этого в системе есть отдельный раздел «Журнал регистрации карт» (журнал документов, тип документа «Автомобиль»): туда загружается Excel-файл со списком, где для каждой строки обязательно указан RFID и наименование, а также желательно IMEI объекта — тогда при проведении документа система сама создаёт (или находит уже существующие) записи автомобилей и объектов доступа, регистрирует карты и связывает RFID с автомобилем по указанному IMEI, без ручной работы по каждой карте.
Полный порядок работы с этим документом (создание, заполнение вручную и загрузкой из Excel, конструктор привязки колонок, сверка строк, проведение) описан в отдельном руководстве — «Регистрация карт — руководство пользователя».
9. Результат: ради чего всё это — отчётность по картам и топливу#
Вся цепочка настройки (сервер → синхронизация объектов → автомобиль в справочнике → привязка RFID-карты к автомобилю) нужна не сама по себе, а ради того, что после неё появляется в разделе «Управление балансом»: каждая выдача топлива по карте автоматически связывается с конкретным автомобилем, и по ней видно бак до/после заправки, отклонение и пробег — без этого связка «карта = автомобиль» отчёту просто неоткуда взять данные.
Та же связка «карта ↔ автомобиль» лежит и в основе печатных/выгружаемых отчётов — например, «Отчёты → Итоги и детали за период по автомобилям»: он группирует те же выдачи по автомобилю и показывает итоги по каждому (выдано, количество заправок, реально попало в бак, отклонение).
10. Права доступа#
| Действие | Кто может |
|---|---|
| Просмотр списка | Администратор, Продвинутый пользователь, Пользователь |
| Добавление / редактирование / удаление | Администратор, Продвинутый пользователь |
| Проверка соединения | Администратор, Продвинутый пользователь |
| Синхронизация объектов / RFID-меток | Администратор, Продвинутый пользователь |