Configurer le webhook d'un site

Crée ou remplace la configuration webhook du site. L'URL cible doit
être en HTTPS et pointer vers un hôte public.

Chaque appel régénère le secret de signature (la configuration
précédente est entièrement remplacée) : récupérez-le dans la réponse,
il signe toutes les livraisons à venir.

Deux authentifications possibles : signature « clé de site » en
?key= (serveur-à-serveur), ou JWT d'un compte propriétaire/
administrateur.

⚠ Sans ?key= et sans JWT valide, la réponse est HTTP 200 avec
un corps {"gcCode": 410, "msg": "route need authentication"} — le
webhook n'est alors pas configuré. Vérifiez l'absence du champ
gcCode avant de considérer la configuration comme enregistrée.

⚠ Les noms d'événements ne sont pas validés côté serveur : une
faute de frappe est acceptée (200, active: true) mais l'événement
mal orthographié ne recevra jamais aucune livraison. Copiez
exactement les types listés ci-dessous.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^[a-f0-9]{24}$

Identifiant interne du site (24 caractères hexadécimaux) — ⚠ le shortname n'est PAS accepté sur les routes webhook.

Body Params
uri
required

URL de réception (HTTPS obligatoire, hôte public).

events
array of strings
required
length ≥ 1

Événements souscrits : comment.created, comment.updated, comment.deleted, comment.approved, ou * pour tout recevoir.

events*
string
enum
Defaults to events

events = une livraison par événement ; sync = un signal sync.wakeup vous invitant à venir chercher les données.

Allowed:
Responses

403

Signature clé de site invalide ou périmée, ou compte sans droit sur ce site.

404

Site inconnu.

500

Erreur serveur ({"error":"Erreur serveur"}).

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json