3.0 KiB
Webhook
:::tip Cette fonction est disponible à partir de la version 12.109.0. :::
:::warning C’est une fonction expérimentale qui peut être instable ou être modifiée à l’avenir. :::
Misskey fournit un webhook qui vous permet de recevoir des évènements Misskey en temps réel.
Vous pouvez les gérer via la section éponyme de vos paramètres.
Une fois défini, une requête HTTP est envoyée à l’URL indiquée chaque fois qu’un évènement défini survient. La requête sera en POST et contiendra du JSON.
De pluis, l’entête de requête contient une clé secrète définie lors de la création avec le nom X-Misskey-Hook-Secret. Celui-ci vous permet de vérifier l’authenticité de la requête.
Les propriétés suivantes seront transmises :
Si le serveur de destination retourne une erreur 5xx ou ne répond pas, la requête est renvoyée après un certain délai.
Les webhooks peuvent être désactivés individuellement depuis le tableau d’administration pour arrêter les requêtes.
Évènement
Ci-dessous une description de chaque type d’évènement.
follow
Lorsque vous suivez une personne.
followed
Lorsqu’une personne vous suit.
unfollow
Lorsque vous arrêtez de suivre une personne.
note
Lorsque vous publiez une note.
reply
Lorsqu’une personne répond à votre note.
renote
Lorsque votre note est renotée.
mention
Lorsqu’une personne vous mentionne.