Webhooks

Webhooki, kas nepazaudē events

HMAC-SHA256 parakstīti payloads, exponential-backoff retries, replay no jebkuras vietas un test-fire poga katrā endpoint.

Konfigurēt webhooks Lasīt spec

8 event tipi

Abonē to, kas svarīgi

Katrs endpoint var pieteikties uz vienu vai vairākiem eventiem. Payload schemas ir versionētas un dokumentētas OpenAPI.

site.created

Jauna vietne izveidota

site.provisioned

Provisioning pabeigts

site.suspended

Vietne auto-apturēta

site.cancelled

Klients atcēla

plugin.installed

Spraudnis pievienots vietnei

plugin.uninstalled

Spraudnis atvienots

invoice.issued

Jauns rēķins izrakstīts

invoice.paid

Rēķins apmaksāts

Parakstīti payloads

Katrs pieprasījums ietver X-RadCMS-Signature header, ko vari pārbaudīt pret sava endpoint signing secret. Noraidi jebkuru pieprasījumu, kas neiztur pārbaudi — tā tu novērsi viltošanu.

HMAC-SHA256 pār raw request body.
Signing secret tiek parādīts vienreiz izveidē, nekad vēlāk.
Rotācija atbalstīta — vecā + jaunā atslēga validē abas 7 dienas.
Replay aizsardzība caur X-RadCMS-Timestamp + 5 minūšu logu.

// PHP — pārbaudīt 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);
// apstrādā $event …

Veidots, lai izdzīvotu tavu downtime

Tavam endpoint sliktā diena nedrīkst pazaudēt eventus. Lūk, kā mēs to risinām.

Exponential backoff

Retries pie 1s, 10s, 1m, 10m, 1h, 1d. Pēc 6 neveiksmīgiem mēģinājumiem endpoint tiek auto-apturēts līdz operatora darbībai.

Replay no jebkuras vietas

Katra piegāde tiek ierakstīta ar pilnu payload + atbildi. Replay atsevišķiem eventiem vai datumu diapazonam ar vienu klikšķi no paneļa.

Per-endpoint test

Spied Test pogu panelī, lai izšautu sample payload uz savu endpoint. Skaties atbildes kodu, body un laiku inline.

Live piegādes log

Pēdējās 7 dienas piegāžu katram endpoint ar HTTP kodu, latency un precīzu request/response.

Auto-atslēgšana pēc N neveiksmēm

6 secīgas neveiksmes apstādina endpoint un nosūta e-pastu tavai komandai. Atkārtoti aktivē no paneļa, kad esi to salabojis.

IP allowlist (Enterprise)

Viss radcms izejošais webhook trafiks nāk no dokumentētas IP kopas. Enterprise klienti var piemērot stingrāku allowlist.

Gatavs savienot savu stack?

Izveido kontu un pievieno pirmo endpoint mazāk nekā minūtē.

Sākt — bez maksas