Webhooks ó rialacha

Is féidir le riail glao a dhéanamh ar URL nuair a thruicearaíonn sí. Ar an mbealach seo, faigheann do chóras féin eolas faoi theagmhas láithreach, mar shampla teocht ard nó dínascadh gléis.

Sula dtosaíonn tú

• Cuireann HAM Systems webhooks ar siúl do gach cuntas. Má thaispeánann an aip Níl webhooks cumasaithe do do chuntas, déan teagmháil leis an tacaíocht.
• Teastaíonn seoladh https:// uait a ghlacann le hiarratais POST ón idirlíon.

Cuir webhook le riail

1. Oscail an Roghchlár. Sa ghrúpa Uirlisí, tapáil Rialacha scamaill.
2. Oscail riail nó déan riail nua. Féach Cruthaigh riail.
3. Sna gníomhartha, tapáil Cuir gníomh leis.
4. Sa liosta, roghnaigh Crochán Gréasáin.
5. Sa réimse URL, clóscríobh seoladh do chórais.
6. Más mian leat glao freisin nuair a athshocraíonn an riail, tapáil Cuir gníomh athshocraithe leis agus roghnaigh Crochán Gréasáin arís.
7. Tapáil Sábháil.

Ríomhaire

Fón

Ríomhaire

Fón

Mura bhfuil an seoladh ceart, taispeánann an aip Níl an URL bailí.

An t-iarratas

Seolann an t-ardán POST le corp 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": []
}

Réimse	Ábhar
event	triggered nuair a thruicearaíonn an riail. resolved nuair a ritheann gníomh Ar athshocrú.
rule.id, rule.name	Uimhir agus ainm na rialach
rule.serialno	Gléas na rialach
rule.this_data	Coinníollacha na rialach
device_data	Staid reatha gach gléis den riail, de réir sraithuimhreach. An fhormáid chéanna le nuashonruithe an WebSocket.
messages	Earráidí, mar shampla Failed to get state of e11:123 for rule #4321 nuair nach bhfuil staid gléis ar fáil

Is luachanna amha iad na luachanna in R. Sa sampla, ciallaíonn T: 912 9.12 °C. Féach na sainmhínithe sa REST API.

Baineann an t-ardán sonraí WiFi an ghléis (ainm an líonra, an pasfhocal agus sonraí fiontair) de device_data.

Cosain an webhook

Níl síniú (HMAC) ag an iarratas. Chun a sheiceáil go dtagann an t-iarratas ó do riail:

1. Déan rún fada randamach, mar shampla le openssl rand -hex 32.
2. Cuir an rún i dteaghrán iarratais an tseolta: https://example.com/ham-hook?token=YOUR_SECRET.
3. I do chóras, diúltaigh do gach iarratas nach bhfuil an token ceart aige.

Aire

Is féidir le gach duine a fheiceann an riail an seoladh leis an rún a fheiceáil freisin. Má athraíonn na daoine le rochtain, athraigh an rún.

Rialacha agus teorainneacha

• Caithfidh an seoladh tosú le https://.
• Ní ghlaonn an t-ardán ar sheoltaí áitiúla ná príobháideacha: 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 agus na seoltaí IPv6 gaolmhara (::1, fe80:, fc00::/7).
• Suas le 5 ghlao in aghaidh 60 soicind do gach gníomh webhook de riail.
• Suas le 30 glao webhook in aghaidh 60 soicind do gach cuntas.
• Ní dhéanann an t-ardán na glaonna os cionn na dteorainneacha. Ní sheolann sé níos déanaí iad.
• Ní sheiceálann an t-ardán stádas HTTP do fhreagra agus ní sheolann sé an t-iarratas arís.
• Is féidir moill (TAR ÉIS) a bheith ag gníomh. Tá suas le 12 ghníomh ar fad ag riail.

Tástáil

Don chéad tástáil, úsáid seirbhís phoiblí a thaispeánann na hiarratais a fhaigheann sí. Déan riail le coinníoll éasca agus féach ar chorp an iarratais.

Féach freisin

• Cad a dhéanann riail: foláireamh nó ordú
• Sonraí beo (WebSocket)
• Slándáil