Kirim data dari perangkat sendiri (HTTP & MQTT)

INCLUDE menerima data dari perangkat apa pun yang bisa mengirim JSON. Daftarkan perangkat di Manage Devices, pilih jenis perangkatnya, lalu simpan device token yang diberikan.

Lewat HTTP

Cara paling sederhana. Token bisa dikirim di header atau langsung di URL.

curl -X POST https://app.include.co.id/api/v1/{DEVICE_TOKEN}/telemetry \
  -H "Content-Type: application/json" \
  -d '{"values":{"voltage":220.5,"current":2.1,"power":462.3}}'

Atau dengan header: POST /api/v1/device/telemetry dan X-Device-Token: {DEVICE_TOKEN}.

Lewat MQTT

Cocok untuk perangkat yang mengirim data sering atau perlu menerima perintah balik.

Username: deviceId
Password: device token
Topik telemetry: includeapps/{group_id}/{solution_slug}/{device_id}/telemetry
Topik perintah: ganti akhiran telemetry dengan command untuk menerima perintah aktuator dan update firmware.

Cara paling aman: ambil konfigurasi host, port, dan topik dari GET /api/v1/{DEVICE_TOKEN}/mqtt-config, jangan disusun manual.

Format payload

Kirim nilai di dalam objek values. Nama field harus sama dengan parameter jenis perangkat yang terdaftar. Contoh energy meter 1 fasa:

{
  "values": {
    "voltage": 220.5,
    "current": 2.1,
    "power": 462.3,
    "energy": 145.2,
    "frequency": 50.0,
    "power_factor": 0.95
  }
}

Energy meter 3 fasa memakai voltage_r, voltage_s, voltage_t, current_r, current_s, current_t, total_power, energy, frequency, dan power_factor. Field yang tidak dikenal tetap tersimpan, tapi tidak tampil di widget bawaan.