HTTP API (Data Entry)
Версия: 1.0
Назначение
HTTPS-канал для приборов и шлюзов, которым неудобен или недоступен MQTT. Альтернативный способ внесения текущих измерительных данных в ту же инфраструктуру облака.
Учётные данные совпадают с MQTT объекта и выдаются в кабинете (диалог «Подключение объекта», раздел HTTPS, QR-код).
Подключение
| Параметр | Значение |
|---|---|
| Протокол | HTTPS (TLS) |
| Хост | relsibcloud.com |
| Порт | 8080 |
| Логин | mqtt_login объекта |
| Пароль | mqtt_passw объекта |
Строка подключения:
relsibcloud.com:8080:<mqtt_login>:<mqtt_passw>
Клиент обязан использовать TLS и проверять сертификат сервера.
Когда выбирать HTTP вместо MQTT
- Сеть разрешает только HTTPS, исходящий MQTT (8883) закрыт.
- Прошивка умеет HTTP-клиент и не реализует MQTT.
- Нужна периодическая передача пакета значений без постоянной MQTT-сессии.
Для потоковой телеметрии с минимальной задержкой предпочтителен MQTT API.
Модель данных
Семантика измерений совпадает с MQTT API:
- привязка к объекту через
mqtt_login; - идентификация прибора и зоны;
- каналы вида
ch:type:val:err(см. MQTT API и «Типы приборов и параметров»).
Контур на порту 8080
| Ресурс | Назначение |
|---|---|
/getzones | Актуальное состояние зон (служебный контур) |
/getdevs | Сведения о приборах |
| приём телеметрии | Текущие данные от HTTP-адаптера прошивки |
Путь и формат тела запроса на запись телеметрии задаются адаптером конкретной модели шлюза. Параметры подключения — из кабинета.
Аутентификация
Те же учётные данные объекта, что и для MQTT. Смена пароля объекта в кабинете затрагивает оба канала. При 401 / 403 проверьте актуальность логина и пароля.
Рекомендации
- Не отключайте проверку TLS-сертификата.
- Избегайте избыточной частоты запросов.
- При сетевых сбоях — повтор с backoff.
- После первой успешной передачи убедитесь в кабинете: зона онлайн, есть свежая метка времени.
Связь с другими API
- MQTT API — основной канал телеметрии.
- HTTP API (Management) — каталог объектов, зон и приборов; не для потоковой записи с датчика.
- WebSocket API — отображение данных в кабинете; запись с прибора не предусмотрена.
Просмотров: 192
Сохранено: 15.06.2025
