HTTP API внесение
v.1

Общие положения

Запросы к системе выполняются по протоколу HTTPS методом GET или POST.
Формат запросов и ответов - TEXT.

API URL: https://relsibcloud.com:8080

Значения параметров зоны

Внесение текущих показаний

Метод: post
URL: /insert

Действие:
Вносит массив новых данных с датчиков в БД.

Формат запроса:
Минимум три строки, в конце каждой строки обязателен символ перевода строки

login
pass
data

где:

"login": логин объекта с которого передаются данные (как для mqtt),
"pass" : пароль объекта,
"data" : текстовое поле, построчно ( n) данные с датчиков в формате (так же как для mqtt)
	datetime dev_type dev_serial zone_id param_num:param_type:param_value:err ...
	datetime dev_type dev_serial zone_id param_num:param_type:param_value:err ...
	...

login и pass - смотреть в интерфейсе на странице объекта
datetime - в формате UNIX TIMESTAMP Если данных нет - поле содержит "0"
dev_type - типа прибора (целое) ^*1 Если данных нет - поле содержит "0"
dev_serial - серийный номер прибора (строка). Если данных нет - поле содержит "-"
zone_id - ИД зоны к оторую передаются измеренные значения (целое)
Повторяющиеся блоки показаний:
param_num - номер параметра (целое 1-4)
param_type - тип значения параметра (целое) ^*2
param_value - значение параметра (целое/вещественное)
err - наличие/отсутствие ошибки (целое 0/номер_ошибки)

^*1 - список типов приборов приведён ниже.
^*2 - список типов значений приведён ниже.



Формат ответа:
В случае успеха сервер вернёт:

ok

Пример запроса:

12Uerrk1YQzF9vKB
OpwZt3gz4vLMvIRx
2024-08-26T15:14:32 1 D2:62:78:D7:3E:18 2 1:1:26.2:0 2:1:752:1 3:2:752:0
                                          
Пояснение:
2024-08-26T15:14:32 1 D2:62:78:D7:3E:18 2 1:1:26.2:0 2:1:752:1 3:2:752:0
------------------- | ----------------- | | | ---- |
  время показаний   | |                 | | | |    ошибка
                    | серийник прибора  | | | |    
                    тип прибора         | | | |    
                                        | | | значение
                                        | | тип зачения
					| номер параметра
                                        ИД зоны

в конце каждой строки обязателен символ перевода строки (n)

Список типов значений

	1  => "температура   (C)",
	2  => "влажность     (%)",
	3  => "co2           (ppm)",
	4  => "давление      (Pa)",
	5  => "освещённость  (lx)",
	6  => "св.поток      (lm)",
	7  => "сопротивление (Om)",
	8  => "напряжение    (Volt)",
	9  => "сила тока     (Amper)",
	10 => "частота       (Hz)",
	11 => "мощность      (Watt)",
	12 => "пыль          (мкг/м3)",
	13 => "контакт       (логич.)",

Список типов приборов

	14 => EClerk-WS-R          - Датчик  открытия/закрытия двери
	13 => EClerk-WS-L          - Датчик протечки, уровня, положения контактов
	8  => EClerk-WS-T          - Датчик температуры
	9  => EClerk-WS-K          - Датчик температуры (термопарный)
	10 => EClerk-WS-HT         - Датчик температуры и влажности
	18 => DVT-03               - Датчик температуры и влажности
	11 => EClerk-WS-QT         - Датчик температуры и уровня освещённости
	12 => EClerk-WS-HTC        - Датчик температуры, влажности, уровня СО2
	15 => EClerk-WS-HTCPm      - Датчик температуры, влажности, уровня СО2, пыли
	17 => IVIT-M               - Измеритель температуры и влажности
	19 => EClerk-Eco-M-RHT-RS  - Измеритель-регистратор температуры и влажности
	20 => EClerk-Eco-M-RHTC-RS - Измеритель-регистратор температуры, влажности, СО2
	24 => PAS-01-V             - Преобразователь напряжения
        23 => PAS-01-mV            - Преобразователь напряжения
        21 => PAS-01-T             - Преобразователь температуры
        22 => PAS-01-I             - Преобразователь тока
        16 => IVIT-1               - Термогигрометр

Просмотров: 6
Сохранено: 15.06.2025

Документация

Типы приборов HTTP API MQTT API HTTP API WebSocket API