Webhook
Un webhook permet d'envoyer des données vers une URL.
Cas d'usage
Les webhooks offrent un moyen simple d'envoyer des données vers un système tiers sur évènements.
Envoi des données
Il existe 2 façons d'envoyer les données avec un webhook :
Envoi des données par GET
Dans le cas d'un envoi de données par GET, les paramètres sont envoyés dans l'URL qui va être appelée.
Par exemple, si le webhook est configuré pour envoyer les données sur l'URL : https://www.monhook.com (et que le système qui traitera la requête est configuré pour accepter les requêtes GET) et que nous souhaitons envoyer les données : titre = bonjour et nom = benjamin, l'url appelée sera https: https://www.monhook.com?titre=bonjour&nom=benjamin
Cette méthode est simple, mais elle limite la taille, la nature et la structure des données envoyées.
Envoi des données par POST
Dans le cas d'un envoi de données par GET, les paramètres sont envoyés dans le corps (body) de la requête envoyée, dans différents formats, le plus utilisé étant JSON.
Exemple :
- Le webhook est configuré pour envoyer les données sur l'URL : https://www.monhook.com (nécessite que le système qui traitera la requête soit configuré pour accepter les requêtes POST)
- Nous souhaitons envoyer les données : titre = bonjour et nom = benjamin
L'url appelée sera https: https://www.monhook.com, et le corps de la requête contiendra (cas du JSON) :
{
"titre": "bonjour",
"nom": "benjamin"
}