Webhooks: Geïnformeerd worden over een wijziging

ISC beschikt over een mechanisme om systemen van derden te informeren wanneer een belangrijke gebeurtenis of trigger in de applicatie plaatsvindt. Voor het ontvangen van een melding moet een URL worden opgegeven die een HTTP GET-aanvraag accepteert. ISC bevat extra triggervelden als parameters die aan de URL worden toegevoegd.

Een set webhooks verzendt een HTTP POST-aanvraag. Met een POST worden gegevenselementen door middel van de geplaatste gegevens verzonden en niet als aanvraagparameters in de URL. De hoofdtekst van de geplaatste gegevens is een JSON-document. Voor de ontvanger moet dus worden ingesteld dat deze een inhoudstype van application/json kan accepteren. Alle webhooks gebruiken GET-aanvragen, tenzij anders vermeld in de documentatie.

Het POST JSON-document bestaat uit drie elementen: beveiliging, algemeen en data. De elementen beveiliging en algemeen bevatten de gegevens die in de volgende sectie zijn gedocumenteerd. Gegevens die specifiek zijn voor de webhookactie zijn beschikbaar in het element data in de volgende sectie.

Bijvoorbeeld: