Skip to main content
Le Commis expose trois méthodes d’intégration. Elles ne sont pas exclusives : on les combine souvent. Cette page vous aide à choisir.

​
Comparatif

MéthodeEffortFraîcheur des donnéesContrôle du renduIdéal pour
API publiqueMoyen — écrire du code de fetch et de renduÀ la demande (vous re-fetchez quand vous voulez)Total — vous produisez votre propre HTMLAfficher des menus structurés, des horaires, l’identité avec votre design
Redirections / fichiersFaible — coller une URLToujours le menu courant (suivi automatique)Aucun — vous affichez le PDF/l’image tels quelsMontrer rapidement un menu sans coder de rendu
WebhooksMoyen — exposer un endpoint HTTPS et vérifier la signatureTemps réel (signal poussé au changement)N/A — ne sert pas à afficherInvalider un cache, relancer un build automatiquement

​
Comment choisir

Choisissez les redirections si vous voulez le minimum d’effort. Vous collez une URL stable dans une balise <img>, <iframe>, <a> ou un bouton, et le navigateur est redirigé vers le fichier du menu courant. Aucun code de rendu à écrire, mais aucun contrôle non plus sur la mise en page : vous affichez le PDF ou l’image tels qu’ils ont été produits dans Le Commis.
L’URL de redirection est stable : elle ne change pas quand le menu est mis à jour. Vous la collez une seule fois, et elle pointe toujours vers le fichier du menu courant. La Carte unifiée (le PDF combiné de toutes les cartes) dispose elle aussi de sa propre URL stable.
Choisissez l’API si vous voulez maîtriser le rendu. Vous lisez les données structurées en JSON (sections, items, prix, allergènes, horaires, coordonnées) et vous générez votre propre HTML, fidèle à la charte du site. C’est plus de travail, mais c’est la seule méthode qui vous donne un contrôle total sur l’affichage et l’accessibilité. Ajoutez les webhooks si vous voulez du temps réel. Un webhook n’affiche rien et ne remplace ni l’API ni les redirections : c’est un signal. À chaque changement de contenu, Le Commis appelle votre endpoint ; à vous de réagir en re-lisant l’API, en purgeant un cache ou en relançant un build. C’est ce qui rend une intégration statique (Astro, Next, cache CDN) auto-actualisée sans cron de polling.
Le schéma le plus robuste combine les trois : l’API pour le rendu, les webhooks pour savoir quand re-fetcher, et le champ content_revision (présent sur l’API comme dans le payload webhook) pour décider si le re-fetch est nécessaire.

​
En savoir plus

API publique

Endpoints, authentification, formats de réponse.

Redirections & fichiers

URLs plug-and-play vers les PDF et images des menus.

Webhooks

Recevoir et vérifier les notifications de changement.