Webhooks

Webhooks li ma jitilfux events

Payloads iffirmati b'HMAC-SHA256, retries bi exponential backoff, replay minn kullimkien u buttuna test-fire fuq kull endpoint.

Ikkonfigura l-webhooks Aqra l-ispeċ

8 tipi ta' event

Issottoskrivi għal dak li jimporta

Kull endpoint jista' jagħżel event wieħed jew aktar. L-iskemi tal-payload huma versjonati u dokumentati f'OpenAPI.

site.created

Site ġdid ipprovvedut

site.provisioned

Il-provisioning lest

site.suspended

Site sospiż awtomatikament

site.cancelled

Il-klijent ikkanċella

plugin.installed

Plugin imqabbad ma' site

plugin.uninstalled

Plugin maqlugħ

invoice.issued

Inħarġet fattura ġdida

invoice.paid

Fattura mħallsa

Payloads iffirmati

Kull talba tinkludi header X-RadCMS-Signature li tista' tivverifika kontra s-signing secret tal-endpoint tiegħek. Irrifjuta kull talba li tonqos mill-verifika — hekk tipprevjeni l-iffalsifikar.

HMAC-SHA256 fuq il-body raw tat-talba.
Is-signing secret jiġi żvelat darba waħda fil-ħolqien, qatt aktar.
Rotazzjoni appoġġjata — keys qodma + ġodda jivvalidaw għal 7 ijiem.
Protezzjoni mir-replay permezz ta' X-RadCMS-Timestamp + tieqa ta' 5 minuti.

// PHP — ivverifika webhook ta' 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);
// ipproċessa $event …

Mibni biex jissopravvivi d-downtime tiegħek

Jekk l-endpoint tiegħek ikollu jum ħażin, ma għandux jitlef events. Hawn kif nimmaniġġjawh.

Exponential backoff

Retries f'1s, 10s, 1m, 10m, 1h, 1d. Wara 6 attentati li jfallu l-endpoint jiġi sospiż awtomatikament jistenna azzjoni mill-operatur.

Replay minn kullimkien

Kull twassil hu rreġistrat bil-payload sħiħ + response. Tista' tagħmel replay ta' events individwali jew firxa ta' dati b'klikk wieħed mid-dashboard.

Test għal kull endpoint

Agħfas buttuna Test fid-dashboard biex tibgħat payload kampjun lill-endpoint tiegħek. Ara r-response code, il-body u t-timing inline.

Delivery log live

L-aħħar 7 ijiem ta' twassil għal kull endpoint, b'HTTP code, latenza u r-request/response eżatt muri.

Diżattivazzjoni awtomatika wara N falliment

6 fallimenti konsekuttivi jaqfu l-endpoint u jibagħtu email lit-team tiegħek. Ergħa attivah mid-dashboard ladarba tiffissah.

Allowlist tal-IP (Enterprise)

It-traffiku kollu tal-webhooks li joħorġu minn radcms jiġi minn sett dokumentat ta' IPs. Il-klijenti Enterprise jistgħu jippinjaw allowlist aktar strett.

Lest tqabbad l-istack tiegħek?

Oħloq kont u żid l-ewwel endpoint tiegħek f'inqas minn minuta.

Ibda — bla ħlas