Skip to main content
L’API Le Commis expose les informations d’un établissement (identité, horaires, menus web) sous forme de JSON, en lecture seule (GET uniquement). Elle se consomme depuis votre backend pour afficher des données à jour sans les recopier à la main.

​
Base URL

Le serveur OpenAPI est https://app.lecommis.fr ; le préfixe /api/v1 fait partie de chaque chemin.
Toutes les routes partagent la même base URL https://app.lecommis.fr/api/v1. Chaque chemin documenté ici s’y ajoute (ex. /establishments/au-bistrot).
L’API est désactivée par défaut. Elle doit d’abord être activée par l’administrateur de l’établissement, depuis la page Réglages de l’établissement → Paramètres de l’API, qui génère également la clé d’accès.

​
Principes

  • Tenant par slug — chaque établissement est identifié par son slug (ex. au-bistrot), jamais par un identifiant numérique.
  • Lecture seule — uniquement des requêtes GET. Aucune écriture n’est possible via l’API.

​
Authentification

Chaque requête doit porter le header X-Api-Key avec la clé de l’établissement. C’est une clé serveur-à-serveur : ne l’exposez jamais dans du JavaScript navigateur.
Exemple d'appel
Détails complets (activation, rotation, codes 401/404) sur la page Authentification.

​
Les 4 endpoints

Le seul paramètre de requête disponible est ?locale=fr|en, et uniquement sur les endpoints menus (liste et détail). Voir Sélection de la langue.

​
Pour aller plus loin

  • Établissement — identité, contact, localisation, logo.
  • Horaires — horaires réguliers et exceptionnels.
  • Menus — liste des menus, sections et items.
  • content_revision — détecter les changements et invalider votre cache.
Consultez aussi les quotas de requêtes, le format des erreurs, et l’onglet API Reference pour le playground interactif : /api-reference.