Webhooks

Webhooks, které neztrácejí události

Payloady podepsané HMAC-SHA256, opakování s exponenciálním backoffem, replay odkudkoli a tlačítko test-fire na každém endpointu.

Konfigurovat webhooky Přečíst spec

8 typů událostí

Odebírej, co tě zajímá

Každý endpoint může opt-in do jedné nebo více událostí. Payload schémata jsou verzována a zdokumentována v OpenAPI.

site.created

Nový sit nasazen

site.provisioned

Provisioning dokončen

site.suspended

Sit auto-pozastaven

site.cancelled

Zákazník zrušil

plugin.installed

Plugin připojen k situ

plugin.uninstalled

Plugin odpojen

invoice.issued

Vygenerována nová faktura

invoice.paid

Faktura uhrazena

Podepsané payloady

Každý požadavek obsahuje hlavičku X-RadCMS-Signature, kterou si můžeš ověřit signing secretem svého endpointu. Odmítni jakýkoli požadavek, který ověření neprojde — tak zabráníš podvržení.

HMAC-SHA256 nad raw request body.
Signing secret se zobrazí jednou při vytvoření, nikdy znovu.
Podporována rotace — starý + nový klíč platí současně 7 dní.
Ochrana proti replay přes X-RadCMS-Timestamp + 5minutové okno.

// PHP — ověření webhooku z radcms
$secret    = env('RADCMS_WEBHOOK_SECRET');
$payload   = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_RADCMS_SIGNATURE'];

$expected = 'sha256=' .
  hash_hmac('sha256', $payload, $secret);

if (! hash_equals($expected, $signature)) {
  http_response_code(401);
  exit('Invalid signature');
}

$event = json_decode($payload, true);
// zpracuj $event …

Postaveno, aby přežilo tvůj výpadek

Když má tvůj endpoint zlý den, události se ztrácet nebudou. Tady je, jak to řešíme.

Exponenciální backoff

Retries v 1s, 10s, 1m, 10m, 1h, 1d. Po 6 neúspěšných pokusech je endpoint auto-pozastaven, dokud nezasáhne operátor.

Replay odkudkoli

Každé doručení je zaznamenáno s plným payloadem + odpovědí. Replay jednotlivých událostí nebo časového rozsahu jedním klikem z dashboardu.

Test pro každý endpoint

Klikni v dashboardu na Test a pošli na svůj endpoint ukázkový payload. Vidíš response code, body a timing inline.

Live log doručení

Posledních 7 dní doručení na endpoint, s HTTP kódem, latencí a přesným request/response.

Auto-vypnutí po N selháních

6 po sobě jdoucích selhání pozastaví endpoint a pošle e-mail tvému týmu. Znovu zapneš z dashboardu, až to opravíš.

IP allowlist (Enterprise)

Veškerý odchozí webhook provoz z radcms pochází z dokumentované sady IP. Enterprise zákazníci mohou zafixovat přísnější allowlist.

Připraven napojit svůj stack?

Vytvoř si účet a přidej první endpoint za méně než minutu.

Začít — je to zdarma