> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lecommis.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Carte unifiée

> Une URL stable qui renvoie vers le fichier de votre Carte unifiée. Toujours servie, sans activation.

La **Carte unifiée** est le document unique (PDF ou image) qui présente toute la carte de l'établissement. C'est le fichier à utiliser quand vous voulez un seul lien « Voir la carte » à afficher partout.

<Note>
  La Carte unifiée est un fichier **téléversé** par l'établissement, **pas** un document généré automatiquement par Le Commis. Elle s'adresse aux établissements qui possèdent déjà une carte complète et ne souhaitent pas (encore) passer par la génération Le Commis. La génération automatique de ce document est prévue plus tard.
</Note>

## Endpoint

```bash theme={null}
GET https://app.lecommis.fr/r/master_menu?establishment={slug}
```

<ParamField query="establishment" type="string" required>
  Le slug de l'établissement (jamais un identifiant numérique). Exemple : `au-bistrot`.
</ParamField>

La réponse est un **302** vers le fichier de la Carte unifiée, hébergé par Le Commis. Cette redirection est **toujours servie** : aucun flag à activer côté établissement.

<Note>
  Le chemin technique reste `/r/master_menu` : seule l'appellation visible change, on parle désormais de la **Carte unifiée**.
</Note>

<Note>
  Si aucune Carte unifiée n'est attachée à l'établissement, la réponse est un **404** avec le texte brut `Menu non disponible`.
</Note>

## Intégration

Collez simplement l'URL dans la page. Le navigateur suit le `302` jusqu'au PDF.

<CodeGroup>
  ```html Bouton « Voir la carte » theme={null}
  <a
    href="https://app.lecommis.fr/r/master_menu?establishment=au-bistrot"
    target="_blank"
    rel="noopener"
    class="btn"
  >
    Voir la carte
  </a>
  ```

  ```html PDF embarqué theme={null}
  <iframe
    src="https://app.lecommis.fr/r/master_menu?establishment=au-bistrot"
    width="100%"
    height="800"
    title="Carte du restaurant"
    style="border: 0"
  ></iframe>
  ```
</CodeGroup>

<Tip>
  L'URL pointe toujours vers la version courante de la Carte unifiée. Quand vous publiez une nouvelle carte dans Le Commis, le lien sert automatiquement le PDF à jour — rien à changer côté intégration.
</Tip>

## Quota de requêtes

Comme toutes les redirections, l'endpoint est limité à **500 requêtes par heure et par IP** (`429` au-delà). Laissez le navigateur ou un CDN mettre le fichier en cache pour le trafic public. Voir [Quota de requêtes](/essentials/rate-limiting).