Webhooks configureren via AO
- Niels
Als SuperUser kun je ook via AO zelf webhooks configureren onder het instellingenmenu:
Hier kom je op een overzichtspagina met alle (actieve) webhooks. Vanaf deze pagina kunnen bestaande webhooks verwijderd worden, de details bekeken en nieuwe webhookconfiguraties worden toegevoegd.
Nieuwe webhookconfiguratie
Door op de toevoegen-knop te drukken opent het volgende scherm:
Hier geef je een herkenbare naam op zodat duidelijk is waar deze webhook voor gebruikt wordt. Momenteel is er maar één definitie beschikbaar, namelijk nl.assistanceonline.webhooks.orderstatuschanged.v1 (zie Webhooks voor meer technische informatie). Zodra een definitie gekozen is zullen ook eventuele resources beschikbaar komen. De methode onder HTTP-instellingen zal in de meeste gevallen Post zijn. De url moet beginnen met https:// en gebruikersnaam en wachtwoord zijn optioneel. Het is pas mogelijk om een wachtwoord in te vullen als er een gebruikersnaam is.
Het blokje met HTTP-headers is ook optioneel, hier kunnen aanvullende headers opgegeven worden. Denk aan API keys of access tokens.
Voor resources zie Webhook resources en filters zie Webhook filters
Detailpagina
Vanaf de detailpagina kunnen de instellingen bewerkt worden, een webhook op actief/inactief gezet worden en de laatste 25 aanroepen bekeken worden.
De 25 meest recente aanroepen worden pas opgehaald als de gebruiker op de knop drukt. Dit is bewust omdat dit een redelijk zware operatie is en er ook veel data opgehaald wordt. Wees dus geduldig wanneer hier gebruik van gemaakt wordt.
Zodra de resultaten beschikbaar zijn kunnen de details bekeken worden.
In de lijst is meteen zichtbaar of een aanroep is geslaagd of niet. Op het rode of groene resultaat blokje kan via een mouseover de toelichting van de statuscode bekeken worden. Vooral de fouten zijn natuurlijk interessant. Door op het ‘document’-knopje aan het eind van een regel te klikken kan het verzonden bericht, de ontvangen reactie en details over de verschillende pogingen bekeken worden.
Â