Webhooks: meldingen krijgen als er iets gebeurt
Kort antwoord
Ga in Portal naar Developers → Webhooks en klik op Add webhook. Stel een naam in, een HTTPS-URL, een payload-formaat (Generic JSON of Slack) en optioneel welke event-topics je wilt ontvangen. Portal stuurt daarna een POST-event naar die URL zodra er iets gebeurt dat hierop past, in plaats van dat jij de API steeds moet bevragen op wijzigingen. Alleen de accounteigenaar kan webhooks beheren.
Een Webhook is het omgekeerde van de API: in plaats van dat jouw script Portal vraagt "is er al iets veranderd?", laat Portal jouw endpoint weten op het moment dat er iets gebeurt. Dat is handig voor alles wat snel moet reageren, denk aan het pagen van je on-call tool, posten in een Slack-kanaal, of het starten van een CI/CD-stap, zonder dat een script op een timer hoeft te pollen.
Een Webhook instellen
Ga naar Developers → Webhooks
Klik op Add webhook.
Vul het formulier in
Name (voor je eigen referentie), URL (moet HTTPS zijn), Format (Generic JSON of Slack), en optioneel Topics (kommagescheiden; laat leeg om elk event-type te ontvangen).
Bewaar de signing secret meteen
Sla het formulier op. De signing secret wordt eenmalig getoond, direct na het aanmaken. Bewaar hem op de plek waar je endpoint inkomende payloads verifieert, je kunt hem daarna niet meer bekijken, alleen opnieuw genereren.
Een bestaande Webhook beheren
Elke Webhook-rij heeft een statuslabel (Healthy, Idle, Failing met een aantal, of Disabled) en een set rijacties: Test (verstuur een voorbeeldevent), Regenerate secret, Enable/Disable en Delete. Begint een webhook te falen, stuur dan eerst een testevent. De meeste fouten zijn een non-2xx-response of een timeout op jouw endpoint, geen probleem aan de kant van de portal.
Veelgebruikte integraties: Webhooks zijn een generieke HTTP POST, dus alles wat er een kan ontvangen werkt: paging-tools zoals PagerDuty of OpsGenie, een Slack-kanaal via het ingebouwde Slack-formaat, of je eigen automatiseringsendpoint. Welke events nuttig zijn om door te sturen hangt af van wat je aan het automatiseren bent. Begin met alles (laat Topics leeg) en bouw het af zodra je ziet wat er daadwerkelijk binnenkomt.
Webhooks
Ontvang realtime meldingen over events via HTTP POST naar je eigen endpoints.
| Name | Status | Actions |
|---|---|---|
| order-alerts | Healthy | Test · Disable · Delete |