HTTP API ile ölçüm gönderin

JSON gövdeli bir HTTP isteği gönderebilen her sistem FreeMaint Connect'i besleyebilir: Node-RED, Home Assistant, Modbus okuyan bir ağ geçidi, bir PLC veya kendi betiğiniz. URL'sini ve erişim anahtarını almak için HTTP API (Node-RED, betik…) türünde bir bağlantı oluşturun.

İstek

Yöntem: POST; bağlantıyı oluştururken gösterilen URL'ye (/connect/ingest/generic ile biter).
Authorization başlığı: Bearer ve ardından erişim anahtarı.
Content-Type: application/json başlığı.
Veriler kabul edildiğinde FreeMaint 202 ile yanıt verir; veriler birkaç saniye içinde saklanır.

Gövde

Gövde, cihazları items altında listeler. Her cihazın bir tanımlayıcısı (device), isteğe bağlı bir görünen adı, isteğe bağlı bir zamanı (ts, ISO 8601) ve noktaları vardır. Her noktanın bir key ve bir value değeri, tercihen de bir unit ve bir quantity değeri bulunur. Oluşturma ekranı kopyalayabileceğiniz eksiksiz bir örnek gösterir.

Nokta alanları

key

Kanalın bu cihazdaki adı, örneğin power veya energy_total. Aynı key her zaman aynı kanala düşer.

value

Bir sayı.

unit

Örneğin W, kWh, °C veya mm/s. Wh ya da MWh cinsinden enerji kWh'ye, sıcaklıklar °C'ye, titreşim hızı mm/s'ye dönüştürülür. Pa, hPa, kPa, mbar, psi, inH2O, inWC veya mmH2O cinsinden basınçlar bar'a çevrilir. Bir kanalı başka bir birimde okumak için FreeMaint'te Görüntüleme birimi seçin. Kanal sayfası, son okumanın birimini «Alınan birim» altında gösterir. Mili ve mega için büyük/küçük harf önemlidir: mW ve mWh mili, MW ve MWh megadır. BACnet birim adları da büyük veya küçük harfle kabul edilir: “PASCALS”, “inches-of-water”, “kilowatt-hours”…

quantity

Ölçülen büyüklük, örneğin power, energy, temperature veya vibration_velocity. FreeMaint'in doğru birimi ve grafiği seçmesini sağlar.

kind

Yalnızca artan bir sayaç (enerji toplamı, çalışma saatleri) için CUMULATIVE. FreeMaint bu durumda okumalar arasındaki tüketimi hesaplar. Basit bir ölçüm değeri için bu alanı kullanmayın.

Sınırlar

İstek başına en fazla 500 cihaz ve 5.000 nokta.
Bağlantı başına dakikada en fazla 120 istek; bunun üzerinde FreeMaint 429 ile yanıt verir ve sisteminizin daha sonra yeniden denemesi gerekir.
Hatalı biçimlendirilmiş bir istek, sorunu belirten bir 400 yanıtı alır; böylece yanlış yapılandırılmış bir ağ geçidi kolayca düzeltilir.
Her yeni kanal, planınızın aktif kanal sınırına dahil edilir.

İpucu

Tipik kurulumlar: bir Modbus enerji sayacını her dakika okuyup değerlerini gönderen bir Node-RED akışı; bir sensörü ileten bir Home Assistant otomasyonu; Data to Server özelliğiyle okumaları gönderen bir Teltonika yönlendirici.

Uyarı

Erişim anahtarını gizli tutun: anahtara sahip olan herkes bu bağlantıya veri gönderebilir. Sızmış olabileceğini düşünüyorsanız yeni bir anahtar oluşturun ve Hemen iptal et seçeneğini seçin.