Webhooks

Webhooki, ki ne izgubljajo eventov

Payloadi podpisani s HMAC-SHA256, retries z eksponentnim backoffom, replay od kjerkoli in test-fire gumb na vsakem endpointu.

Konfiguriraj webhooke Preberi spec

8 tipov eventov

Naroči se na to, kar pomeni

Vsak endpoint se lahko opt-ina v enega ali več eventov. Sheme payloadov so verzionirane in dokumentirane v OpenAPI.

site.created

Nov sajt provisioniran

site.provisioned

Provisioning končan

site.suspended

Sajt samodejno suspendiran

site.cancelled

Stranka je preklicala

plugin.installed

Vtičnik priklopljen na sajt

plugin.uninstalled

Vtičnik odklopljen

invoice.issued

Nov račun izdan

invoice.paid

Račun poravnan

Podpisani payloadi

Vsak zahtevek vključuje header X-RadCMS-Signature, ki ga lahko preveriš proti signing secretu svojega endpointa. Zavrni vsak zahtevek, ki ne prestane verifikacije — tako preprečuješ ponaredek.

HMAC-SHA256 nad surovim request bodyjem.
Signing secret se prikaže enkrat ob kreaciji, nikoli več.
Podprta je rotacija — star + nov ključ veljata vzporedno 7 dni.
Replay zaščita prek X-RadCMS-Timestamp + 5-minutnega okna.

// PHP — verifikacija radcms webhooka
$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);
// obdelaj $event …

Zgrajeno, da preživi tvoj downtime

Tvoj slab dan endpointa ne sme izgubiti eventov. Tukaj je, kako to obravnavamo.

Eksponentni backoff

Retries pri 1s, 10s, 1m, 10m, 1h, 1d. Po 6 neuspelih poskusih je endpoint samodejno suspendiran do posredovanja operaterja.

Replay od kjerkoli

Vsaka dostava je zabeležena s polnim payloadom + odzivom. Replay posameznih eventov ali datumskega razpona z enim klikom iz nadzorne plošče.

Per-endpoint test

Pritisni Test v nadzorni plošči, da pošlješ vzorčni payload na svoj endpoint. Vidi response kodo, body in timing inline.

Živi delivery log

Zadnjih 7 dni dostav na endpoint, s HTTP kodo, latenco in natančnim prikazom request/response.

Samodejno onemogočanje po N napakah

6 zaporednih napak postavi endpoint v pavzo in pošlje email tvoji ekipi. Ponovno omogočiš iz nadzorne plošče, ko je popravljen.

IP allowlist (Enterprise)

Ves odhodni webhook promet radcms izhaja iz dokumentiranega niza IP-jev. Enterprise stranke lahko pripnejo strožji allowlist.

Pripravljen, da povežeš svoj stack?

Ustvari račun in dodaj svoj prvi endpoint v manj kot minuti.

Začni — brezplačno je