Catalogue d'événements

Cette page liste les événements de webhook que Le Commis peut émettre. Aujourd’hui, un seul événement métier existe : establishment.content_updated.

`establishment.content_updated`

Émis lorsque le contenu d’un établissement change (profil, horaires, menus, Carte unifiée). C’est un signal : le payload n’embarque pas le contenu, seulement de quoi savoir quoi re-lire.

Payload

{
  "delivery_id": "whd_3f9a...",
  "type": "establishment.content_updated",
  "created_at": "2026-06-14T10:00:00Z",
  "data": {
    "establishment_slug": "au-bistrot",
    "content_revision": 67,
    "changed_resources": ["menus", "business_hours"]
  }
}

Champs

string

Identifiant unique de la livraison. Identique à l’en-tête X-LeCommis-Delivery. Utilisez-le pour dédupliquer les livraisons rejouées.

string

Le type d’événement, ici establishment.content_updated.

string (ISO 8601)

Date de création de l’événement, en UTC.

object

Données de l’événement.

Show data

string

Le slug de l’établissement concerné. Sert à cibler les bons appels API (/establishments/{slug}/...).

integer

La nouvelle valeur de content_revision de l’établissement, après le changement. Entier monotone, par établissement, indépendant de la locale.

string[]

La liste des types de ressources qui ont changé depuis la dernière livraison. Sous-ensemble de profile, business_hours, special_hours, menus, master_menu (la Carte unifiée). Plusieurs valeurs peuvent apparaître si des changements rapprochés ont été fusionnés (voir le debounce).

Traitez toujours changed_resources comme un ensemble pouvant contenir plusieurs valeurs, et concevez votre handler pour ignorer une valeur inconnue plutôt que d’échouer : de nouvelles ressources pourront s’y ajouter à l’avenir.

Quel endpoint re-lire pour chaque ressource

Mappez chaque valeur de changed_resources vers l’endpoint API à rafraîchir :

`changed_resources`	Ce qui a changé	Endpoint à re-lire
`profile`	Identité de l’établissement (nom, description, contact, localisation, logo…)	`GET /establishments/{slug}`
`business_hours`	Horaires d’ouverture réguliers	`GET /establishments/{slug}/hours`
`special_hours`	Horaires exceptionnels à venir	`GET /establishments/{slug}/hours`
`menus`	Un ou plusieurs menus web (liste et/ou détail)	`GET /establishments/{slug}/menus`
`master_menu`	La Carte unifiée (PDF combiné de toutes les cartes)	`GET /establishments/{slug}/menus` — champ `master_menu_url`

En pratique, beaucoup d’intégrations ignorent le détail de changed_resources et se contentent de comparer content_revision à la dernière valeur connue, puis re-fetchent ce dont elles ont besoin. C’est plus simple et tout aussi correct. Voir content_revision.

Événement de test

Le bouton « test delivery » des Paramètres de l’API envoie un événement establishment.webhook_test à votre URL. Il suit le même format d’en-têtes et de signature que les événements réels, ce qui vous permet de valider votre vérification de signature de bout en bout sans attendre un vrai changement de contenu.

D’autres familles d’événements arriveront (notifications de domaine au-delà du simple contenu publiable). Consultez la roadmap pour suivre les ajouts. Concevez votre handler pour ignorer poliment un type inconnu plutôt que d’échouer.

Démarrer

API

Redirections & fichiers de menu

Webhooks

Langues & i18n

Référence

Évolutions

Catalogue d'événements

`establishment.content_updated`

Champs

Quel endpoint re-lire pour chaque ressource

Événement de test

​establishment.content_updated

​Champs

​Quel endpoint re-lire pour chaque ressource

​Événement de test

`establishment.content_updated`

Champs

Quel endpoint re-lire pour chaque ressource

Événement de test