Backend ja SDK

Webhookit

Lähetä sovelluksen tapahtumia Zapieriin, Makeen, n8n:ään tai omalle palvelimellesi.

Avaa editorissa Asetukset → Webhookit, liitä vastaanottavan osoitteen URL ja tallenna (Starter-paketti ja ylemmät). Sen jälkeen builder77 lähettää jokaisesta tapahtumasta POST-pyynnön JSON-rungolla:

TapahtumaMilloin
record.createdSovelluksesi loi tietueen
record.updatedTietue päivitettiin
record.deletedTietue poistettiin
user.signed_upJoku rekisteröityi sovellukseesi
test.pingKlikkasit ”Lähetä testitapahtuma”
{
  "event": "record.created",
  "projectId": "abc123",
  "timestamp": "2026-10-01T10:00:00.000Z",
  "collection": "orders",
  "record": { "id": "…", "total": 42, "createdAt": "…" }
}

Pyyntöjen varmentaminen

Jokaisessa pyynnössä on X-M77-Signature-otsake: raa'an rungon heksadesimaalinen HMAC-SHA256, laskettu allekirjoitussalaisuudellasi (näkyy Asetuksissa).

import crypto from 'node:crypto';
const expected = crypto.createHmac('sha256', process.env.M77_WEBHOOK_SECRET).update(rawBody).digest('hex');
if (expected !== req.headers['x-m77-signature']) return res.status(401).end();

Webhookit toimitetaan kerran 8 sekunnin aikakatkaisulla. URL-osoitteiden on oltava julkisia (yksityisverkkojen osoitteet estetään).