Lewati ke konten

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

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 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).