Hantar ukuran dengan API HTTP

Mana-mana sistem yang boleh menghantar permintaan HTTP dengan badan JSON boleh menyuapkan data ke FreeMaint Connect: Node-RED, Home Assistant, get laluan yang membaca Modbus, PLC atau skrip anda sendiri. Cipta sambungan jenis API HTTP (Node-RED, skrip…) untuk mendapatkan URL dan kunci aksesnya.

Permintaan

Kaedah: POST, ke URL yang dipaparkan semasa anda mencipta sambungan (berakhir dengan /connect/ingest/generic).
Pengepala Authorization: Bearer diikuti oleh kunci akses.
Pengepala Content-Type: application/json.
FreeMaint membalas 202 apabila data diterima; data disimpan dalam beberapa saat.

Badan permintaan

Badan permintaan menyenaraikan peranti di bawah items. Setiap peranti mempunyai pengecam (device), nama paparan pilihan, masa pilihan (ts, ISO 8601) dan titik datanya. Setiap titik mempunyai key, value dan, sebaik-baiknya, unit serta quantity. Skrin penciptaan memaparkan contoh lengkap yang boleh anda salin.

Medan titik data

key

Nama saluran pada peranti ini, contohnya power atau energy_total. Key yang sama sentiasa masuk ke saluran yang sama.

value

Satu nombor.

unit

Contohnya W, kWh, °C atau mm/s. Tenaga dalam Wh atau MWh ditukar kepada kWh, suhu kepada °C dan halaju getaran kepada mm/s. Tekanan dalam Pa, hPa, kPa, mbar, psi, inH2O, inWC atau mmH2O ditukar kepada bar. Untuk membaca saluran dalam unit lain, pilih Unit paparan dalam FreeMaint. Halaman saluran memaparkan unit bacaan terakhir di bawah “Unit diterima”. Huruf besar dan kecil penting untuk mili dan mega: mW dan mWh ialah mili, MW dan MWh ialah mega. Nama unit BACnet juga diterima, dalam huruf besar atau kecil: “PASCALS”, “inches-of-water”, “kilowatt-hours”…

quantity

Kuantiti yang diukur, contohnya power, energy, temperature atau vibration_velocity. Ia membolehkan FreeMaint memilih unit dan carta yang betul.

kind

CUMULATIVE bagi pembilang yang hanya meningkat (jumlah tenaga, jam operasi). FreeMaint kemudian mengira penggunaan antara bacaan. Abaikan medan ini bagi nilai ukuran biasa.

Had

Sehingga 500 peranti dan 5,000 titik data bagi setiap permintaan.
Sehingga 120 permintaan seminit bagi setiap sambungan; melebihi itu FreeMaint membalas 429 dan sistem anda perlu mencuba semula kemudian.
Permintaan yang tidak sah formatnya menerima respons 400 yang menyatakan masalahnya, jadi get laluan yang salah konfigurasi mudah dibetulkan.
Setiap saluran baharu dikira dalam had saluran aktif pelan anda.

Petua

Contoh persediaan biasa: aliran Node-RED yang membaca meter tenaga Modbus setiap minit lalu menghantar nilainya; automasi Home Assistant yang memajukan data sesuatu penderia; penghala Teltonika yang menghantar bacaan melalui ciri Data to Server.

Amaran

Rahsiakan kunci akses: sesiapa yang memilikinya boleh menghantar data ke sambungan ini. Jika kunci mungkin telah bocor, jana kunci baharu dan pilih Batalkan sekarang.