Referensi endpoint
Semua path di bawah /api/v1/workspaces/{ws} kecuali dinyatakan lain. Endpoint tersedia untuk PAT bila scope-nya diberikan. Impor CSV bersifat semua-atau-tidak-sama-sekali (dryRun: true untuk pratinjau).
| Area | Endpoint |
|---|---|
| Workspace | GET .../ (ringkasan dan hak efektif), PATCH, DELETE (hanya pemilik, bukan PAT) |
| Channels dan Devices | channels, devices (CRUD, import CSV), connections (POST, POST .../disconnect), devices/{id}/key |
| Groups | groups, groups/tree, groups/{id}/children, groups/{id}/members?kind=device|channel, groups/import |
| Rules | rules (CRUD), rules/quick-store, rules/test, rules/{id}/run, rules/{id}/executions, rules/test-postgres, custom-nodes |
| Pesan | messages, messages/aggregate, messages/names, messages/series, messages/value, messages/send, messages/export.csv, messages/stream (SSE) |
| Dashboard dan Report | dashboards, dashboards/{id}/share, dashboards/{id}/duplicate, reports, reports/{id}/run (POST), reports/{id}/runs, reports/{id}/runs/{runId}/download |
| Alarm | alarms (daftar), alarms/summary, alarms/export.csv, alarms/{id}/acknowledge, .../resolve, .../assign, .../comments, alarms/bulk, alarms/settings |
| Provisioning | device-types, bootstrap/profiles, bootstrap/configs |
| Status | presence/devices, devices/{id}/presence, devices/{id}/roster (gateway), devices/{id}/last-messages |
| Katalog Metrik | metric-catalog (GET, POST), metric-catalog/defaults (POST), metric-catalog/{id} (PATCH, DELETE), metric-catalog/export |
| Template setelan | device-config-templates (GET, POST), .../catalog, .../{id} (GET, PUT, DELETE), .../{id}/apply (POST {deviceIds, overwrite, channelId, form, push, dryRun}) |
| Konfigurasi device | devices/{id}/device-config (GET; PUT draf), .../device-config/push (POST), devices/{id}/command (POST), devices/{id}/command-result (GET) |
| Kontrol output massal | device-outputs/send (POST {deviceIds, output: "o1".."o4", state, seconds, channelId, form, dryRun}) |
| Rules di device | devices/{id}/device-rules (GET; PUT draf), .../device-rules/push, .../confirm, .../cancel, .../rollback, .../current, .../check |
| Set rule | device-rule-sets (CRUD), .../{id}/apply, .../{id}/bindings, device-rule-rollouts |
| Firmware OTA | firmware (GET; POST multipart), firmware/{id}, firmware/rollouts, .../{id}/pause|resume|cancel|retry|skip, devices/{id}/firmware |
Perintah ke perangkat
Section titled “Perintah ke perangkat”Satu perintah (misalnya menyalakan output) memakai POST .../devices/{id}/command:
{ "channelId": "<channel-id>", "command": { "action": "output", "output": "o1", "state": true, "seconds": 30 } }Izin device.configure dibutuhkan, dan tujuan harus diikuti oleh device itu sendiri atau gateway perantaranya. Jawaban perangkat dibaca dengan GET .../devices/{id}/command-result (cocokkan id perintah).
Endpoint publik tanpa login
Section titled “Endpoint publik tanpa login”| Endpoint | Fungsi |
|---|---|
GET /api/v1/public/dashboards/{token} dan .../data?widget=&source= |
Dashboard dengan tautan publik. Token berfungsi sebagai kredensial, dibatasi 300 permintaan per menit per token. |
POST /api/bootstrap/{ws}/challenge dan .../claim |
Protokol Bootstrap. |
GET /api/fw/{token}/{nama} |
Unduhan firmware bertanda tangan (OTA). |