Руководство разработчика — для инженера и интегратора, который связывает Waliot с внешней системой: учетной, BI, ERP или собственной платформой заказчика. Данные уходят во внешние системы ретрансляцией и читаются через API; прием телеметрии из внешней платформы — отдельная настройка.
Ретрансляция передает данные выбранных объектов на сервер внешней системы: текущие уходят с небольшой задержкой, а накопленное за выбранный период можно отправить кнопкой «Отправить историю» в карточке сервера.
Поддерживаемые протоколы ретрансляции:
Ретрансляция передает телеметрию такой, как ее принял сервер от трекера: состав и частота записей определяются трекером, а адрес, порт и протокол сообщает оператор приемной системы.
Waliot передает данные в ЭРА-ГЛОНАСС, ФГИС ЛК и РНИС ретрансляцией по ЕГТС (адреса — в реестре получателей на странице «Ретрансляция данных во внешние системы»); требования к аппаратуре спутниковой навигации выполняет сертифицированное оборудование.
Через API доступно все, что доступно в интерфейсах Waliot, — по правам пользователя, на которого выпущен ключ API. В публичной документации описаны основные методы для ознакомления: https://dev.waliot.com/api; остальные возможности — по запросу в техническую поддержку. Документация позволяет выполнять тестовые запросы прямо в веб-браузере: они уходят в рабочую систему с вашим ключом API. Файл спецификации для Swagger/Postman и генераторов кода: https://dev.waliot.com/api/api.yaml.
Особенности:
time-zone (по умолчанию GMT+03:00). Границы периода from и to принимаются в ISO 8601 со смещением (например, +03:00) или с Z; знак + в адресе запроса передается как %2B (URL encoding).version: VER_1 (по умолчанию) — названия столбцов переведенными строками, VER_2 — литеральными константами, удобными для своей локализации и отрисовки таблиц, VER_3 — каждый элемент отчета объектом со своим типом.GET /reports/custom/default-report-column-types; например, уровень топлива на начало и конец периода — startFuel и endFuel.Граница периода в UTC сдвигается на смещение часового пояса: запрос за 1 марта в часовом поясе MSK задает границу 2026-02-28T21:00:00Z — это не данные за 28 февраля, а полночь 1 марта по Москве: MSK опережает UTC на три часа. Сравнивая ответ API с тем, что видно в интерфейсе, приводите обе стороны к одному часовому поясу.
Актуальные данные интеграция получает периодическим опросом метода состояний. Поток координат по ссылке шеринга доступен и по WebSocket; для интеграций под ключом API WebSocket не используется. Примеры запросов — на странице Примеры запросов Waliot API.
Для внешних интеграций публичное API принимает ключ API; токены JWT предназначены для клиентских веб-приложений Waliot. Ключ передается в каждом запросе в заголовке Authorization: ApiKey <ключ API>: префикс ApiKey, пробел и сам ключ, регистр важен.
Нужной возможности нет в публичной документации — напишите в техническую поддержку: остальные возможности API предоставляются по запросу.
Готовые модули есть для 1С; другие системы подключаются через API и ретрансляцию. Для BI-систем данные выгружают регулярно через API в промежуточную базу данных, откуда их читает BI-система.
Официальная интеграция Waliot с 1С:УАТ поддерживает:
Возможности:
Подробнее в разделе Интеграция с 1С:УАТ.
Универсальный интеграционный модуль от официального партнера «Аркис» поддерживает:
Возможности:
Подробнее в разделе Интеграционный модуль 1С-Waliot.