Backend ja SDK

Webhookit

Lähetä sovelluksen tapahtumia muihin työkaluihisi tai omalle palvelimellesi.

Avaa editorissa Asetukset → Webhookit (Lisäasetukset-kohdassa), liitä vastaanottavan palvelun URL-osoite ja tallenna (Starter-paketista alkaen). Sen jälkeen builder77 lähettää jokaisesta tapahtumasta POST-pyynnön, jonka runko on JSON-muodossa:

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, joka on 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, ja aikakatkaisu on 8 sekuntia. URL-osoitteiden on oltava julkisia (yksityisverkkojen osoitteet estetään).