Webhookai

Webhookai, kurie nepraranda įvykių

HMAC-SHA256 pasirašyti payload-ai, exponential-backoff pakartojimai, perlaidos iš bet kur ir test-fire mygtukas kiekvienam endpoint.

Konfigūruoti webhookus Skaityti specifikaciją

8 įvykių tipai

Užsisakyk tai, kas svarbu

Kiekvienas endpoint gali užsisakyti vieną ar daugiau įvykių. Payload schemos versionuojamos ir dokumentuojamos OpenAPI.

site.created

Sukurta nauja svetainė

site.provisioned

Provisioning baigtas

site.suspended

Svetainė automatiškai sustabdyta

site.cancelled

Klientas atšaukė

plugin.installed

Įskiepis prijungtas prie svetainės

plugin.uninstalled

Įskiepis atjungtas

invoice.issued

Sugeneruota nauja sąskaita

invoice.paid

Sąskaita apmokėta

Pasirašyti payloads

Kiekviena užklausa apima X-RadCMS-Signature antraštę, kurią gali patikrinti pagal savo endpoint pasirašymo paslaptį. Atmesk bet kurią užklausą, neperžengusią patikrinimo — taip užkertamas kelias klastojimui.

HMAC-SHA256 virš neapdoroto užklausos turinio.
Pasirašymo paslaptis atskleidžiama vieną kartą sukūrimo metu, daugiau niekada.
Palaikoma rotacija — seni + nauji raktai galioja 7 dienas.
Apsauga nuo replay per X-RadCMS-Timestamp + 5 minučių langą.

// PHP — patikrink radcms webhook
$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);
// apdorok $event …

Sukurta išgyventi tavo downtime

Tavo endpoint blogos dienos neturi prarasti įvykių. Štai kaip mes tai tvarkome.

Exponential backoff

Pakartojimai 1s, 10s, 1m, 10m, 1h, 1d. Po 6 nesėkmingų bandymų endpoint automatiškai sustabdomas, laukiama operatoriaus veiksmų.

Replay iš bet kur

Kiekvienas pristatymas įrašomas su pilnu payload + atsakymu. Perleisk pavienius įvykius arba datų intervalą vienu paspaudimu iš skydelio.

Per-endpoint testas

Paspausk Test mygtuką skydelyje, kad išsiųstum pavyzdinį payload į savo endpoint. Pamatyk atsakymo kodą, kūną ir laiką inline.

Gyvas pristatymo žurnalas

Paskutinės 7 dienos pristatymų vienam endpoint su HTTP kodu, latency ir tikslus request/response.

Auto-išjungimas po N nesėkmių

6 nuoseklios nesėkmės sustabdo endpoint ir el. paštu informuoja tavo komandą. Pakartotinai įjunk iš skydelio, kai tai pataisysi.

IP allowlist (Enterprise)

Visas radcms išvykstantis webhook srautas kyla iš dokumentuoto IP rinkinio. Enterprise klientai gali užfiksuoti griežtesnį allowlist.

Pasiruošęs prijungti savo stacką?

Sukurk paskyrą ir pridėk pirmą endpoint mažiau nei per minutę.

Pradėti — tai nemokama