Webhookit

Webhookit jotka eivät hukkaa eventtejä

HMAC-SHA256-allekirjoitetut payloadit, eksponentiaalisesti backoffaavat uudelleenyritykset, replay mistä tahansa ja test-fire-nappi jokaisella endpointilla.

Konfiguroi webhookit Lue määrittely

8 eventtityyppiä

Tilaa se mikä on tärkeää

Jokainen endpoint voi tilata yhden tai useamman eventin. Payload-skeemat ovat versiotuja ja dokumentoituja OpenAPI:ssa.

site.created

Uusi sivusto provisioitu

site.provisioned

Provisiointi valmis

site.suspended

Sivusto autom. keskeytetty

site.cancelled

Asiakas peruutti

plugin.installed

Lisäosa liitetty sivustoon

plugin.uninstalled

Lisäosa irrotettu

invoice.issued

Uusi lasku luotu

invoice.paid

Lasku maksettu

Allekirjoitetut payloadit

Jokainen pyyntö sisältää X-RadCMS-Signature-headerin, jonka voit varmistaa endpointtisi signing secretillä. Hylkää kaikki pyynnöt jotka eivät läpäise varmistusta — näin estät väärennökset.

HMAC-SHA256 raa'an request bodyn yli.
Signing secret näytetään kerran luonnin yhteydessä, ei koskaan uudelleen.
Avainten rotaatio tuettu — vanha + uusi avain validoivat molemmat 7 päivän ajan.
Replay-suojaus X-RadCMS-Timestamp + 5 minuutin ikkuna.

// PHP — verifioi 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);
// käsittele $event …

Rakennettu kestämään katkoksesi

Endpointtisi huono päivä ei saa hukata eventtejä. Tässä miten käsittelemme sen.

Eksponentiaalinen backoff

Uudelleenyritykset 1s, 10s, 1m, 10m, 1h, 1d. Kuuden epäonnistuneen yrityksen jälkeen endpoint keskeytetään automaattisesti odottamaan operaattorin toimia.

Replay mistä tahansa

Jokainen toimitus tallentuu täydellä payloadilla + responsella. Replayaa yksittäisiä eventtejä tai päivämääräväli yhdellä klikkauksella paneelista.

Per-endpoint-testi

Paina Testaa-nappia paneelissa lähettääksesi esimerkkipayloadin endpointtillesi. Näe vastauskoodi, body ja ajoitus inline.

Live-toimituksen loki

Viimeisten 7 päivän toimitukset per endpoint, HTTP-koodilla, viiveellä ja tarkka pyyntö/vastaus näytettynä.

Auto-poisto N epäonnistumisen jälkeen

6 peräkkäistä epäonnistumista tauottaa endpointin ja lähettää sähköpostin tiimillesi. Ota uudelleen käyttöön paneelista kun olet korjannut.

IP-sallittu lista (Enterprise)

Kaikki radcms:n lähtevä webhook-liikenne tulee dokumentoidusta IP-joukosta. Enterprise-asiakkaat voivat kiinnittää tiukemman allowlistin.

Valmis yhdistämään stackisi?

Luo tili ja lisää ensimmäinen endpointtisi alle minuutissa.

Aloita — ilmaiseksi