Kirim pengukuran dengan API HTTP

Sistem apa pun yang dapat mengirim permintaan HTTP dengan body JSON dapat mengisi FreeMaint Connect: Node-RED, Home Assistant, gateway yang membaca Modbus, PLC, atau skrip buatan Anda. Buat koneksi bertipe API HTTP (Node-RED, skrip…) untuk mendapatkan URL dan kunci aksesnya.

Permintaan

Metode: POST, ke URL yang ditampilkan saat Anda membuat koneksi (berakhiran /connect/ingest/generic).
Header Authorization: Bearer diikuti kunci akses.
Sertakan header Content-Type: application/json.
FreeMaint menjawab 202 jika data diterima; data disimpan dalam hitungan detik.

Body

Body mencantumkan perangkat di dalam items. Setiap perangkat memiliki pengenal (device), nama tampilan opsional, waktu opsional (ts, ISO 8601), dan titik-titik datanya. Setiap titik memiliki key, value, dan idealnya unit serta quantity. Layar pembuatan koneksi menampilkan contoh lengkap yang dapat Anda salin.

Kolom titik data

key

Nama kanal pada perangkat ini, misalnya power atau energy_total. Key yang sama selalu masuk ke kanal yang sama.

value

Sebuah angka.

unit

Misalnya W, kWh, °C, atau mm/s. Energi dalam Wh atau MWh dikonversi ke kWh, suhu ke °C, dan kecepatan getaran ke mm/s. Tekanan dalam Pa, hPa, kPa, mbar, psi, inH2O, inWC, atau mmH2O dikonversi ke bar. Untuk membaca kanal dalam satuan lain, pilih Satuan tampilan di FreeMaint. Halaman kanal menampilkan satuan pembacaan terakhir di bawah “Satuan diterima”. Huruf besar dan kecil berpengaruh untuk mili dan mega: mW dan mWh berarti mili, MW dan MWh berarti mega. Nama satuan BACnet juga diterima, huruf besar maupun kecil: “PASCALS”, “inches-of-water”, “kilowatt-hours”…

quantity

Besaran yang diukur, misalnya power, energy, temperature, atau vibration_velocity. Dengan ini FreeMaint dapat memilih satuan dan grafik yang tepat.

kind

CUMULATIVE untuk penghitung yang hanya bertambah (total energi, jam operasi). FreeMaint lalu menghitung konsumsi di antara pembacaan. Kosongkan untuk nilai ukur biasa.

Batasan

Hingga 500 perangkat dan 5.000 titik data per permintaan.
Hingga 120 permintaan per menit per koneksi; di atas itu FreeMaint menjawab 429 dan sistem Anda sebaiknya mencoba lagi nanti.
Permintaan yang formatnya salah mendapat respons 400 yang menyebutkan masalahnya, sehingga gateway yang salah konfigurasi mudah diperbaiki.
Setiap kanal baru dihitung dalam batas kanal aktif paket Anda.

Tips

Contoh pengaturan umum: alur Node-RED yang membaca meter energi Modbus setiap menit lalu mengirimkan nilainya; otomatisasi Home Assistant yang meneruskan data sebuah sensor; router Teltonika yang mengirim pembacaan lewat fitur Data to Server.

Peringatan

Rahasiakan kunci akses: siapa pun yang memilikinya dapat mengirim data ke koneksi ini. Jika kunci mungkin bocor, buat kunci baru dan pilih Cabut sekarang.