Webhooks mir-regoli

Regola tista’ ssejjaħ URL meta tiskatta. B’dan il-mod is-sistema tagħkom issir taf b’avveniment minnufih, pereżempju temperatura għolja jew apparat li skonnettja.

Qabel ma tibdew

HAM Systems tixgħel il-webhooks għal kull kont. Jekk l-app turi Il-Webhooks mhumiex attivati għall-kont tiegħek, ikkuntattjaw is-support.
Għandkom bżonn indirizz https:// li jaċċetta talbiet POST mill-internet.

Żidu webhook ma’ regola

Iftħu l-Menu. Fil-grupp Għodod, agħfsu Regoli tal-cloud.
Iftħu regola jew agħmlu regola ġdida. Araw oħolqu regola.
Fl-azzjonijiet, agħfsu Żid azzjoni.
Fil-lista, agħżlu Webhook.
Fil-qasam URL, iktbu l-indirizz tas-sistema tagħkom.
Jekk tridu wkoll sejħa meta r-regola terġa’ lura, agħfsu Żid azzjoni ta’ reset u agħżlu Webhook mill-ġdid.
Agħfsu Issejvja.

Regola ġdida b'kundizzjonijiet u azzjonijiet — Kompjuter

Azzjoni ta' regola ssettjata għal Webhook bil-qasam URL mimli — Kompjuter

Jekk l-indirizz mhuwiex korrett, l-app turi L-URL mhix valida.

It-talba

Il-pjattaforma tibgħat POST b’body JSON (Content-Type: application/json):

{
  "event": "triggered",
  "rule": {
    "id": 4321,
    "name": "Fridge 1 temperature",
    "serialno": "e11:123",
    "this_data": [ { "...": "the rule conditions" } ]
  },
  "device_data": {
    "e11:123": {
      "R": { "T": 912, "GI": 1, "GIC": 0, "GI2": 1, "GI2C": 0 },
      "O": [],
      "S": { "...": "the device settings" }
    }
  },
  "messages": []
}

Qasam	Kontenut
`event`	`triggered` meta r-regola tiskatta. `resolved` meta taħdem azzjoni Mar-reset.
`rule.id`, `rule.name`	In-numru u l-isem tar-regola
`rule.serialno`	L-apparat tar-regola
`rule.this_data`	Il-kundizzjonijiet tar-regola
`device_data`	L-istat attwali ta’ kull apparat tar-regola, skont in-numru tas-serje. L-istess format tal-aġġornamenti tal-WebSocket.
`messages`	Żbalji, pereżempju `Failed to get state of e11:123 for rule #4321` meta l-istat ta’ apparat mhuwiex disponibbli

Il-valuri f’R huma mhux ipproċessati. Fl-eżempju, T: 912 ifisser 9.12 °C. Araw id-definizzjonijiet fir-REST API.

Il-pjattaforma tneħħi d-dettalji tal-WiFi tal-apparat (isem tan-network, password u dettalji enterprise) minn device_data.

Ipproteġu l-webhook

It-talba m’għandhiex firma (HMAC). Biex tiċċekkjaw li t-talba ġejja mir-regola tagħkom:

Agħmlu sigriet twil u każwali, pereżempju b’openssl rand -hex 32.
Poġġu s-sigriet fil-query string tal-indirizz: https://example.com/ham-hook?token=YOUR_SECRET.
Fis-sistema tagħkom, irrifjutaw kull talba li m’għandhiex it-token korrett.

Regoli u limiti

L-indirizz irid jibda b’https://.
Il-pjattaforma ma ssejjaħx indirizzi lokali u privati: localhost, 127.0.0.0/8, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 169.254.0.0/16, 100.64.0.0/10, 0.0.0.0/8 u l-indirizzi IPv6 relatati (::1, fe80:, fc00::/7).
Sa 5 sejħiet kull 60 sekonda għal kull azzjoni webhook ta’ regola.
Sa 30 sejħa webhook kull 60 sekonda għal kull kont.
Il-pjattaforma taqbeż is-sejħiet ’il fuq mil-limiti. Ma tibgħathomx aktar tard.
Il-pjattaforma ma tiċċekkjax l-istatus HTTP tat-tweġiba tagħkom u ma tibgħatx it-talba mill-ġdid.
Azzjoni jista’ jkollha dewmien (WARA). Regola għandha sa 12-il azzjoni b’kollox.

Test

Għall-ewwel test, użaw servizz pubbliku li juri t-talbiet li jirċievi. Agħmlu regola b’kundizzjoni faċli u araw il-body tat-talba.

Araw ukoll

Chat mal-appoġġ