Webhookok

Webhookok, amelyek nem ejtenek eventeket

HMAC-SHA256-tal aláírt payloadok, exponenciális backoffos retries, replay bárhonnan és test-fire gomb minden endpointon.

Webhookok beállítása Olvasd a specet

8 event típus

Iratkozz fel arra, ami fontos

Minden endpoint egy vagy több eventre is opt-inelhet. A payload sémák verziózottak és dokumentáltak az OpenAPI-ban.

site.created

Új site provisionölve

site.provisioned

Provisioning befejezve

site.suspended

Site automatikusan felfüggesztve

site.cancelled

Az ügyfél lemondta

plugin.installed

Bővítmény csatolva site-hoz

plugin.uninstalled

Bővítmény leválasztva

invoice.issued

Új számla generálva

invoice.paid

Számla rendezve

Aláírt payloadok

Minden kérés tartalmaz egy X-RadCMS-Signature headert, amelyet az endpointod aláíró titka alapján ellenőrizhetsz. Utasítsd el azt a kérést, amely nem megy át az ellenőrzésen — így előzöd meg a hamisítást.

HMAC-SHA256 a nyers request body felett.
Az aláíró titok egyszer jelenik meg létrehozáskor, többé soha.
A rotáció támogatott — a régi és új kulcsok együtt érvényesek 7 napig.
Replay-védelem X-RadCMS-Timestamp + 5 perces ablak révén.

// PHP — radcms webhook ellenőrzése
$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);
// $event feldolgozása …

Túléli a te kiesésedet is

Az endpointod rossz napjai nem okozhatnak event-vesztést. Így kezeljük.

Exponenciális backoff

Retries 1s, 10s, 1m, 10m, 1h, 1d ütemezéssel. 6 sikertelen próbálkozás után az endpoint automatikusan felfüggesztésre kerül, operátori beavatkozásra várva.

Replay bárhonnan

Minden kézbesítést rögzítünk a teljes payloaddal + válasszal. Egyetlen kattintással replayezhetsz egyedi eventeket vagy időszakot a vezérlőpultból.

Endpointonkénti teszt

Nyomd meg a Teszt gombot a vezérlőpulton egy minta payload elküldéséhez. A válaszkódot, body-t és időzítést inline látod.

Élő kézbesítési napló

Az elmúlt 7 nap kézbesítései endpointonként, HTTP kóddal, latency-vel és a pontos request/response-szal.

Auto-letiltás N hiba után

6 egymás utáni hiba szünetelteti az endpointot és e-mailt küld a csapatodnak. A vezérlőpultból újraengedélyezheted, ha javítottad.

IP allowlist (Enterprise)

A radcms minden kimenő webhook forgalma dokumentált IP-készletről származik. Az Enterprise ügyfelek szigorúbb allowlistot rögzíthetnek.

Készen állsz a stacked összekötésére?

Hozz létre fiókot és add hozzá az első endpointod kevesebb mint egy perc alatt.

Kezdés — ingyenes