> ## 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.

# Introduction

> Diffusez l'identité, les horaires et les menus d'un établissement vers vos sites grâce à l'API, aux redirections et aux webhooks Le Commis.

Le Commis est un SaaS pour les **établissements** qui veulent centraliser leur identité (nom, description, coordonnées, logo), leurs **horaires**, leurs **menus** et leurs **fichiers** (PDF et images). Cette documentation s'adresse aux intégrateurs qui veulent rediffuser ces données vers un site externe.

Trois méthodes complémentaires sont à votre disposition.

<CardGroup cols={3}>
  <Card title="API" icon="code" href="/integrations/api/overview">
    Lisez les données structurées d'un établissement en JSON (identité, horaires, menus) depuis votre backend.
  </Card>

  <Card title="Redirections & fichiers" icon="link" href="/integrations/redirects/overview">
    Collez une URL stable dans un `<img>` ou `<iframe>` : elle redirige vers le PDF ou l'image du menu courant.
  </Card>

  <Card title="Webhooks" icon="bell" href="/integrations/webhooks/overview">
    Recevez un signal en temps réel à chaque changement de contenu pour re-lire l'API ou relancer un build.
  </Card>
</CardGroup>

## Quelle méthode pour quel besoin ?

| Besoin                                                              | Méthode recommandée     |
| ------------------------------------------------------------------- | ----------------------- |
| Afficher des menus structurés (sections, items, prix, allergènes)   | API                     |
| Construire votre propre rendu HTML des horaires ou de la carte      | API                     |
| Afficher rapidement le PDF ou l'image d'un menu sans coder de rendu | Redirections & fichiers |
| Mettre un lien direct vers la Carte unifiée téléchargeable          | Redirections & fichiers |
| Invalider un cache ou relancer un build quand le contenu change     | Webhooks                |
| Garder un site statique (Astro, Next) à jour sans cron de polling   | Webhooks                |

<Note>
  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.
</Note>

<Card title="Commencer" icon="rocket" href="/essentials/quickstart">
  Activez l'API et réussissez votre premier appel en quelques minutes.
</Card>