Referentie
Kanaal-webhooks
Berichten in een chatkanaal plaatsen vanuit een externe dienst.
Bijgewerkt:
Deze vertaling is uitsluitend voor het gemak. In geval van afwijking is de Engelse versie doorslaggevend.
Een webhook is een URL die een HTTP-POST-verzoek omzet in een bericht in één kanaal. Deze wordt gebruikt om waarschuwingen, buildresultaten en monitoringuitvoer in Chat te bezorgen.
Een webhook aanmaken
Open het kanaal → Instellingen → Webhooks → Toevoegen. De toegekende naam wordt weergegeven als auteur van elk bericht dat via de webhook wordt geplaatst.
Bij het aanmaken wordt een URL met een token geretourneerd. Het token vormt de autorisatie voor het kanaal en dient als inloggegeven te worden behandeld. Een gecompromitteerd token kan worden verwijderd.
Een bericht plaatsen
Een JSON-body met een tekstveld.
curl -X POST https://app.beskos.com/api/public/chat/hook/<token> \
-H 'Content-Type: application/json' \
-d '{"text": "Deploy finished: build 1284 is live"}'Snelheidslimieten
Het eindpunt is per bronadres in snelheid begrensd, aangezien het zonder authenticatie bereikbaar is. Gebruikelijke volumes voor waarschuwingen worden niet beïnvloed.