Fara beint í efni

n8n-samþætting

Með n8n geturðu unnið sjálfkrafa úr komandi sorphirðudögum – til dæmis fyrir ýtitilkynningar, Slack- eða Matrix-skilaboð, snjallheimilisaðgerðir eða eigin verkferla. Samþættingin virkar í gegnum webhook-kerfi binable: binable sendir daglega HTTP POST á n8n-verkferilinn þinn kl. 18:00 þegar sorphirða er á dagskrá eftir tilgreindan fjölda daga.

1. Búðu til API-lykil

Til að búa til webhooks þarftu fyrst API-lykil.

Fáðu ókeypis API-lykil

2. Búðu til Webhook Trigger í n8n

Bættu Webhook-trigger-hnút við sem fyrsta hnút í n8n-verkferlinum þínum:

Virkjaðu verkferilinn (rofinn „Active“ efst til hægri) svo n8n útvegi móttökuslóðina. Full webhook-slóð er:

https://<deine-n8n-instanz>/webhook/muell-abfuhr

3. Skráðu webhook hjá binable

Skráðu n8n-webhook-slóðina í gegnum binable-API-ið:

curl -X POST https://binable.app/api/webhook \
  -H "Authorization: ApiKey <dein-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://<deine-n8n-instanz>/webhook/muell-abfuhr",
    "daysBeforeCollection": 1,
    "street": "Musterstraße",
    "houseNumber": "1a",
    "zip": "12345",
    "city": "Musterstadt",
    "country": "DE"
  }'

Svarið inniheldur secret sem þú þarft fyrir valfrjálsa sannprófun undirskriftar.

4. Unnið úr gögnunum

Þegar sorphirða er á dagskrá sendir binable POST með eftirfarandi meginmáli á n8n-webhookinn þinn:

{
  "event": "upcoming_collection",
  "sent_at": "2024-01-14T18:00:00+00:00",
  "days_until": 1,
  "address": {
    "street": "Musterstraße",
    "houseNumber": "1a",
    "zip": "12345",
    "city": "Musterstadt",
    "country": "DE"
  },
  "collections": [
    { "type": "Restmüll", "date": "2024-01-15" },
    { "type": "Papier",   "date": "2024-01-15" }
  ]
}

Í n8n eru reitirnir beint aðgengilegir í gegnum webhook-hnútinn. Tengdu síðan hvaða aðgerðahnúta sem er – eins og Send Email, Slack, Telegram, ntfy eða HTTP Request-hnút fyrir eigin kerfi.

5. Valfrjálst: Sannprófun undirskriftar

Hver móttekin beiðni inniheldur hausinn X-Binable-Signature: sha256=<hmac>. Til að tryggja að beiðnin komi raunverulega frá binable geturðu bætt Code-hnút á undan aðgerðunum þínum í n8n til að athuga undirskriftina:

const crypto = require('crypto');
const secret = '<dein-webhook-secret>';
const body = JSON.stringify($input.first().json);
const sig = $input.first().headers['x-binable-signature'];
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(body).digest('hex');
if (sig !== expected) throw new Error('Invalid signature');
return $input.all();

Nánari upplýsingar um allt webhook-API-ið er að finna í skjölun webhook-samþættingarinnar. Webhook-Integrationsdokumentation.

Webhook
Sendu sorphirðudaga sjálfkrafa á slóðina þína
API
Sorphirðudagar um HTTP-API í eigin öppum
Home Assistant
Sorphirðudagar sem skynjari og dagatal

← Yfirlit yfir samþættingar  ·  Öll API-skjölunin