Menus - Le Commis API

L’API menus expose deux endpoints : la liste des menus web et le détail d’un menu (avec ses sections et items). Les deux acceptent ?locale=fr|en. La liste expose également l’URL de la Carte unifiée (champ master_menu_url), le PDF qui combine toutes les cartes de l’établissement.

Méthode	Chemin	Description
`GET`	`/establishments/{slug}/menus`	Liste des menus web
`GET`	`/establishments/{slug}/menus/{menu_type_slug}`	Détail d’un menu

Le menu_type_slug est stable par établissement (ex. menu-du-midi). Vous pouvez le coder en dur dans votre intégration. Si le menu n’existe pas (ou n’a pas de version courante), l’API renvoie 404 {"error":"Not found"}.

Langue

Ajoutez ?locale=fr ou ?locale=en pour choisir la langue du contenu. Valeur absente sur le détail → fr. Valeur invalide → coercée silencieusement en fr. Seuls les noms/descriptions d’items et noms de sections sont traduits ; avec un repli en → fr si une traduction manque. Voir Sélection de la langue.

Liste des menus
Détail d'un menu

GET /api/v1/establishments/{slug}/menus

Exemple

curl "https://app.lecommis.fr/api/v1/establishments/au-bistrot/menus?locale=fr" \
  -H "X-Api-Key: VOTRE_CLE_API"

Réponse 200

{
  "content_revision": 67,
  "master_menu_url": "https://app.lecommis.fr/files/au-bistrot/carte-unifiee.pdf",
  "menus": [
    {
      "menu_type": { "slug": "menu-du-midi", "name": "Menu du midi", "kind": "menu" },
      "reference_date": "2026-06-13",
      "assets": [
        { "language_scope": "fr", "urls": ["https://app.lecommis.fr/menus/au-bistrot/menu-du-midi/web_fr.png"] }
      ]
    }
  ]
}

Champs de la réponse

URL du PDF de la Carte unifiée de l’établissement (toutes les cartes combinées en un seul document), si disponible.

menus

array

Liste des menus web courants.

Show menus[]

Show menu_type

slug

string

Identifiant stable du type de menu (à utiliser pour l’endpoint détail).

name

string

Nom affichable du menu.

kind

string

menu (offre composée) ou card (carte).

reference_date

string | null

Date de référence du menu, au format YYYY-MM-DD.

assets

array

Fichiers du menu (image(s) ou PDF), exposés via le champ assets. Voir ci-dessous.

content_revision

integer

Numéro de révision du contenu (commun à toutes les ressources). Voir content_revision.

GET /api/v1/establishments/{slug}/menus/{menu_type_slug}

Le détail reprend les champs d’un menu de la liste et ajoute sections, avec les items.

Exemple

curl "https://app.lecommis.fr/api/v1/establishments/au-bistrot/menus/menu-du-midi?locale=fr" \
  -H "X-Api-Key: VOTRE_CLE_API"

Réponse 200

{
  "content_revision": 67,
  "menu_type": { "slug": "menu-du-midi", "name": "Menu du midi", "kind": "menu" },
  "reference_date": "2026-06-13",
  "assets": [
    { "language_scope": "fr", "urls": ["https://app.lecommis.fr/menus/au-bistrot/menu-du-midi/web_fr.png"] }
  ],
  "sections": [
    {
      "name": "Entrées",
      "position": 1,
      "items": [
        {
          "id": 42,
          "name": "Salade César",
          "description": "Romaine, parmesan, croûtons, sauce César",
          "price": "12.50",
          "a_la_carte": true,
          "gluten_free": false,
          "vegetarian": true,
          "vegan": false,
          "chef_recommendation": false
        }
      ]
    }
  ]
}

Réponse 404 (menu inexistant)

{ "error": "Not found" }

Champs de la réponse

Identique à la liste : slug, name, kind (menu | card).

reference_date

string | null

Date de référence du menu, au format YYYY-MM-DD.

assets

array

Fichiers du menu (image ou PDF), champ assets (voir la section Fichiers du menu ci-dessous).

sections

array

Sections du menu, ordonnées par position.

Show sections[]

name

string

Nom de la section (ex. Entrées). Traduit selon ?locale.

position

integer

Ordre d’affichage de la section.

items

array

Show items[]

integer

Identifiant de l’item.

name

string

Nom de l’item. Traduit selon ?locale.

description

string | null

Description de l’item. Traduite selon ?locale.

price

string | null

Prix sérialisé en chaîne décimale (ex. "12.50"). null hors items à la carte.

a_la_carte

boolean

true si l’item est proposé à la carte (avec un prix propre).

gluten_free

boolean

Sans gluten.

vegetarian

boolean

Végétarien.

vegan

boolean

Végan.

chef_recommendation

boolean

Recommandation du chef.

content_revision

integer

Numéro de révision du contenu (commun à toutes les ressources). Voir content_revision.

Chaque menu porte un tableau assets. Une entrée du champ assets décrit un ou plusieurs fichiers du menu (un menu peut s’étaler sur plusieurs pages).

assets[].language_scope

string

Langues couvertes par le fichier : fr, en, ou fr_en (un fichier fr_en couvre les deux langues).

assets[].urls

array

Tableau d’URLs des fichiers (image ou PDF). Plusieurs entrées = plusieurs pages.

Sans ?locale, tous les language_scope sont renvoyés. Avec ?locale, seuls les fichiers correspondant à la langue demandée (y compris fr_en) sont retournés.

Il n’y a aucun repli de langue sur les fichiers du menu. Un fichier peut exister en fr et être absent en en. Contrôlez toujours language_scope avant d’afficher un fichier, et prévoyez le cas où aucun fichier ne correspond à la langue demandée. Voir Comportement de repli.

Pour servir un fichier du menu directement via une URL plug-and-play (<img>, <iframe>…) sans appeler l’API, voyez les redirections de fichiers du menu.

​Langue

​Exemple

​Champs de la réponse

​Exemple

​Champs de la réponse

​Fichiers du menu (champ assets)

Langue

Exemple

Champs de la réponse

Exemple

Champs de la réponse

Fichiers du menu (champ `assets`)