Odesílání downlinků

Zařízení můžete ovládat i přes API. Downlink se zařadí do fronty a doručí se při dalším startu zařízení, při odeslání uplinku nebo když se zařízení dotáže Cloudu — odpověď tedy nemusí být okamžitá (viz Downlink). Existují tři druhy, každý má vlastní endpoint pod /v2/spaces/{space_id}/devices/{device_id}:

Konfigurace

POST …/devices/{device_id}/configs — tělo je JSON pole příkazů app config:

curl -X POST \
  -H 'X-API-KEY: <api-key>' \
  -H 'Content-Type: application/json' \
  'https://api.hardwario.cloud/v2/spaces/<space-id>/devices/<device-id>/configs' \
  -d '["app config interval-report 1800", "app config interval-sample 60"]'

Neposílejte config save

Cloud konfiguraci použije a uloží automaticky. Když config save přidáte sami, může se změna aplikovat dvakrát — vynechte jej.

Příkaz shellu

POST …/devices/{device_id}/commands — tělo je JSON pole příkazů shellu; odpověď na každý příkaz dostanete zpět ve zprávě:

curl -X POST \
  -H 'X-API-KEY: <api-key>' \
  -H 'Content-Type: application/json' \
  'https://api.hardwario.cloud/v2/spaces/<space-id>/devices/<device-id>/commands' \
  -d '["info show", "app config show"]'

Data

POST …/devices/{device_id}/downlinks — tělo je JSON objekt, který dekóduje firmware vašeho zařízení:

curl -X POST \
  -H 'X-API-KEY: <api-key>' \
  -H 'Content-Type: application/json' \
  'https://api.hardwario.cloud/v2/spaces/<space-id>/devices/<device-id>/downlinks' \
  -d '{ "relay": true, "setpoint": 21.5 }'