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

# Développeurs — vue d'ensemble

> L'API REST Solya POS : le backend documenté qui expose toutes les capacités de la Caisse et de la Centrale, compatible MCP pour les agents IA.

L'**API Solya POS** est le backend, documenté. Tout ce que la
[Caisse](/fr/caisse/overview) et la [Centrale](/fr/centrale/overview) savent
faire, une intégration — ou un agent IA — peut le faire via cette API REST.

## Ce qu'il faut savoir pour commencer

<CardGroup cols={2}>
  <Card title="Authentification" icon="key" href="/fr/developers/authentication">
    Deux façons de s'authentifier : un jeton d'accès Keycloak (JWT) ou un jeton
    de session POS opaque — les deux sont acceptés.
  </Card>

  <Card title="Faire des requêtes" icon="paper-plane" href="/fr/developers/making-requests">
    L'URL de base, le préfixe <code>/v1</code>, l'enveloppe de réponse et la
    pagination.
  </Card>

  <Card title="Codes d'erreur" icon="triangle-exclamation" href="/fr/developers/error-codes">
    L'enveloppe d'erreur et la correspondance <code>ResultCode</code> → statut
    HTTP.
  </Card>

  <Card title="Agents & MCP" icon="robot" href="/fr/developers/agent-mcp">
    La surface prête pour les agents : <code>x-agent-tier</code>,
    <code>x-required-permissions</code> et le flux de découverte MCP.
  </Card>
</CardGroup>

## La surface documentée

* `GET /openapi.json` — le document OpenAPI 3.0 généré, qui ne contient **que**
  les opérations explicitement documentées (la surface intentionnelle, prête pour
  les agents).
* `GET /docs` — Swagger UI par-dessus ce document.
* `GET /v1/auth/whoami` — les permissions `pos.*` effectives de l'appelant, pour
  une découverte des opérations sensible aux droits.

Le document OpenAPI est **généré au démarrage** du backend et régénéré en CI ; il
n'est plus committé. Chaque route documentée porte un `operationId` unique, sa
sécurité, ses permissions requises et des exemples valides.

## Référence API

La [Référence API](/fr/developers/authentication) détaille chaque opération,
regroupée par domaine (ventes & encaissement, catalogue & stock, finance, clients
& fidélité, marketing & promotions, services, système), générée directement
depuis le spec OpenAPI du backend.