Backend a SDK

Webhooky

Posílej události z aplikace do Zapieru, Make, n8n nebo na vlastní server.

V editoru otevři Nastavení → Webhooky, vlož URL endpointu a ulož (tarif Starter a vyšší). builder77 pak při každé události pošle POST s tělem v JSON:

UdálostKdy
record.createdTvoje aplikace vytvořila záznam
record.updatedZáznam byl upraven
record.deletedZáznam byl smazán
user.signed_upNěkdo se v tvé aplikaci zaregistroval
test.pingKliknutí na „Odeslat testovací událost“
{
  "event": "record.created",
  "projectId": "abc123",
  "timestamp": "2026-10-01T10:00:00.000Z",
  "collection": "orders",
  "record": { "id": "…", "total": 42, "createdAt": "…" }
}

Ověření požadavků

Každý požadavek má hlavičku X-M77-Signature: hexadecimální HMAC-SHA256 surového těla, vypočtený pomocí tvého podpisového tajemství (najdeš ho v Nastavení).

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();

Webhooky se doručují jednou s časovým limitem 8 sekund. URL musí být veřejně dostupná (adresy privátních sítí jsou blokované).