Trimiteți măsurători prin API-ul HTTP

Orice sistem care poate trimite o cerere HTTP cu un corp JSON poate alimenta FreeMaint Connect: Node-RED, Home Assistant, un gateway care citește Modbus, un automat programabil (PLC) sau propriul dvs. script. Creați o conexiune de tip „API HTTP (Node-RED, script…)” pentru a obține URL-ul și cheia de acces.

Cererea

Metodă: POST, către URL-ul afișat la crearea conexiunii (se termină cu /connect/ingest/generic).
Antetul Authorization: Bearer, urmat de cheia de acces.
Antetul Content-Type: application/json.
FreeMaint răspunde cu 202 când datele sunt acceptate; ele sunt stocate în câteva secunde.

Corpul cererii

Corpul enumeră dispozitivele în items. Fiecare dispozitiv are un identificator (device), un nume afișat opțional, un moment opțional (ts, ISO 8601) și punctele sale. Fiecare punct are un key, un value și, ideal, un unit și un quantity. Ecranul de creare afișează un exemplu complet pe care îl puteți copia.

Câmpurile unui punct

key

Numele canalului pe acest dispozitiv, de exemplu power sau energy_total. Același key ajunge întotdeauna pe același canal.

value

Un număr.

unit

De exemplu W, kWh, °C sau mm/s. Energia în Wh sau MWh este convertită în kWh, temperaturile în °C, iar viteza de vibrație în mm/s. Presiunile în Pa, hPa, kPa, mbar, psi, inH2O, inWC sau mmH2O sunt convertite în bar. Pentru a citi un canal în altă unitate, alegeți-i Unitate de afișare în FreeMaint. Pagina canalului afișează unitatea ultimei citiri la „Unitate primită”. Pentru mili și mega contează literele mari și mici: mW și mWh sunt mili, MW și MWh sunt mega. Sunt acceptate și numele de unități BACnet, cu litere mari sau mici: „PASCALS”, „inches-of-water”, „kilowatt-hours”…

quantity

Mărimea măsurată, de exemplu power, energy, temperature sau vibration_velocity. Îi permite lui FreeMaint să aleagă unitatea și graficul potrivite.

kind

CUMULATIVE pentru un contor care doar crește (un total de energie, ore de funcționare). FreeMaint calculează atunci consumul dintre citiri. Omiteți-l pentru o simplă valoare măsurată.

Limite

Până la 500 de dispozitive și 5.000 de puncte pe cerere.
Până la 120 de cereri pe minut pe conexiune; peste această limită, FreeMaint răspunde cu 429, iar sistemul dvs. ar trebui să reîncerce mai târziu.
O cerere incorectă primește un răspuns 400 care numește problema, astfel încât un gateway configurat greșit se corectează ușor.
Fiecare canal nou se socotește în limita de canale active a planului dvs.

Sfat

Configurații tipice: un flux Node-RED care citește în fiecare minut un contor de energie Modbus și îi trimite valorile; o automatizare Home Assistant care transmite datele unui senzor; un router Teltonika a cărui funcție Data to Server trimite citirile.

Avertisment

Păstrați secretă cheia de acces: oricine o are poate trimite date către această conexiune. Dacă este posibil să fi fost divulgată, generați o cheie nouă și alegeți „Revocă acum”.