Данные · 25 августа 2026

Как передать данные устройств в свою систему по API

Варианты интеграции, структура данных и на что обратить внимание, чтобы показания приборов и датчиков надёжно попадали в вашу систему.

APIданные устройств в вашей системе

Сеть передачи данных — только половина задачи. Вторая половина — чтобы показания и события с устройств попадали в вашу систему: биллинг, диспетчерскую, ERP или аналитику. Разберём, как это обычно устроено.

Три способа интеграции

  • Запрос по API. Ваша система по расписанию запрашивает новые данные за период. Просто в реализации, подходит для ежедневных показаний.
  • Отправка в вашу систему (webhook). Данные приходят сразу после получения сообщения от устройства. Нужно, когда важна скорость реакции — например, для сигналов о протечке.
  • Регулярная выгрузка. Файл в согласованном формате по расписанию. Подходит, если в системе нет API.

Что приходит в данных

Для каждого сообщения обычно передаются идентификатор устройства, время, значения и служебная информация. Пример структуры (поля согласуются под проект):

{
  "device_id": "000A1B2C",
  "timestamp": "2026-08-25T06:00:00+05:00",
  "values": { "volume_m3": 128.457 },
  "events": ["low_battery"],
  "battery_pct": 34,
  "signal_dbm": -121
}

На что обратить внимание

  • Справочник устройств. Сопоставьте идентификаторы устройств с вашими объектами: адресом, лицевым счётом, точкой учёта.
  • Время. Договоритесь о часовом поясе и о том, какое время считать моментом показаний.
  • Повторы и пропуски. Система должна спокойно обрабатывать повторно полученное сообщение и отмечать устройства, от которых давно нет данных.
  • Безопасность. Доступ по ключам, шифрованное соединение, при необходимости — ограничение по IP-адресам.

Как начать

Опишите, в какую систему и с какой частотой нужны данные, — согласуем способ интеграции и формат. Ordanet доставляет данные с устройств в системы заказчиков по API или регулярной выгрузкой.

Читайте также