Skip to main content
Le Commis est un SaaS pour restaurants. Chaque établissement centralise son identité (nom, description, coordonnées, logo), ses horaires, ses menus et leurs fichiers (PDF et images). Cette documentation s’adresse aux intégrateurs qui veulent rediffuser ces données vers un site externe : page restaurant, carte en ligne, widget d’horaires, build statique, etc. Trois méthodes complémentaires sont à votre disposition.

API publique

Lisez les données structurées d’un établissement en JSON (identité, horaires, menus) depuis votre backend.

Redirections & fichiers

Collez une URL stable dans un <img> ou <iframe> : elle redirige vers le PDF ou l’image du menu courant.

Webhooks

Recevez un signal en temps réel à chaque changement de contenu pour re-lire l’API ou relancer un build.

Quelle méthode pour quel besoin ?

BesoinMéthode recommandée
Afficher des menus structurés (sections, items, prix, allergènes)API publique
Construire votre propre rendu HTML des horaires ou de la carteAPI publique
Afficher rapidement le PDF ou l’image d’un menu sans coder de renduRedirections & fichiers
Mettre un lien direct vers la Carte unifiée téléchargeableRedirections & fichiers
Invalider un cache ou relancer un build quand le contenu changeWebhooks
Garder un site statique (Astro, Next) à jour sans cron de pollingWebhooks

À qui s’adresse cette doc

Aux freelances, agences web et intégrateurs qui construisent ou maintiennent le site d’un restaurant. Que vous travailliez sous WordPress, Astro, Next, ou tout autre stack, les trois méthodes s’utilisent depuis n’importe quel langage : un appel HTTP suffit pour l’API, une URL suffit pour les redirections, un endpoint HTTPS suffit pour recevoir les webhooks.
La base URL de l’API est https://app.lecommis.fr/api/v1. L’API est en lecture seule (uniquement des requêtes GET) et opt-in : elle doit d’abord être activée par l’administrateur de l’établissement dans les réglages avant de pouvoir l’appeler. Vous ne pouvez donc jamais modifier de données via l’API, seulement les lire.

Commencer

Activez l’API et réussissez votre premier appel en quelques minutes.