Webhooky

Webhooky, ktoré nestrácajú udalosti

Payloady podpísané HMAC-SHA256, retries s exponenciálnym backoffom, replay odkiaľkoľvek a test-fire tlačidlo na každom endpointe.

Nakonfigurovať webhooky Prečítaj spec

8 typov udalostí

Prihlás sa na to, čo je dôležité

Každý endpoint sa môže prihlásiť na jednu alebo viacero udalostí. Schémy payloadov sú verzionované a zdokumentované v OpenAPI.

site.created

Nová stránka vytvorená

site.provisioned

Provisioning hotový

site.suspended

Stránka automaticky pozastavená

site.cancelled

Zákazník zrušil

plugin.installed

Plugin pripojený k stránke

plugin.uninstalled

Plugin odpojený

invoice.issued

Vystavená nová faktúra

invoice.paid

Faktúra uhradená

Podpísané payloady

Každý request obsahuje hlavičku X-RadCMS-Signature, ktorú môžeš overiť oproti signing secret tvojho endpointu. Odmietni každý request, ktorý overenie nesplní — takto zabrániš podvrhu.

HMAC-SHA256 nad surovým telom requestu.
Signing secret sa zobrazí raz pri vytvorení, nikdy znova.
Podporovaná rotácia — starý + nový kľúč platia obidva 7 dní.
Ochrana proti replay cez X-RadCMS-Timestamp + 5-minútové okno.

// PHP — overenie 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);
// spracovať $event …

Postavené prežiť tvoj downtime

Keď má tvoj endpoint zlý deň, nemali by sa stratiť udalosti. Takto to riešime.

Exponenciálny backoff

Retries pri 1s, 10s, 1m, 10m, 1h, 1d. Po 6 neúspešných pokusoch sa endpoint automaticky pozastaví do zásahu operátora.

Replay odkiaľkoľvek

Každé doručenie sa zaznamenáva s plným payloadom + odpoveďou. Replay jednotlivých udalostí alebo časového rozsahu jedným klikom z dashboardu.

Test pre každý endpoint

Klikni Test v dashboarde a pošli sample payload na svoj endpoint. Response kód, telo a timing uvidíš inline.

Live log doručení

Posledných 7 dní doručení na endpoint, s HTTP kódom, latenciou a presným request/response.

Auto-vypnutie po N zlyhaniach

6 po sebe idúcich zlyhaní pozastaví endpoint a pošle e-mail tímu. Znova zapni z dashboardu, keď to opravíš.

IP allowlist (Enterprise)

Všetka odchádzajúca webhook prevádzka radcms pochádza zo zdokumentovanej sady IP adries. Enterprise zákazníci si môžu pripnúť prísnejší allowlist.

Pripravený prepojiť svoj stack?

Vytvor si účet a pridaj svoj prvý endpoint za menej ako minútu.

Začať — je to zdarma