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

# Référence de l'API

> Chaque route de l'API REST de Lekalao, avec un bac à sable.

Cette référence est générée à partir du document OpenAPI de Lekalao. Chaque page décrit une route : paramètres, corps, réponses, exemples en `curl`, JavaScript, PHP et Python.

## Essayer

Le bouton **Essayer** de chaque page envoie un vrai appel :

1. Dans **Serveur**, remplacez `lekalao.example.com` par l'adresse de votre Lekalao.
2. Dans **Authorization**, collez un jeton (**Paramètres → Jetons d'API**).

<Warning>
  Le bac à sable agit sur vos vraies données. Utilisez une équipe de test ou
  un jeton **Lecture** pour explorer.
</Warning>

## En bref

|                  |                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------- |
| Adresse          | `https://votre-lekalao/api/v1`                                                           |
| Authentification | `Authorization: Bearer <jeton>`. Voir [Authentification](/fr/developers/authentication). |
| Format           | JSON ; `Accept: application/json`.                                                       |
| Identifiants     | `id`, un uuid.                                                                           |
| Pagination       | `page`, `per_page` (100 au plus) ; `links` et `meta` dans la réponse.                    |
| Limite           | 120 appels par minute par jeton.                                                         |
| Idempotence      | En-tête `Idempotency-Key` sur les écritures, 24 heures.                                  |

Le détail est dans [Conventions](/fr/developers/conventions) et [Erreurs](/fr/developers/errors).

## Le document OpenAPI

Chaque installation sert le sien, à jour de sa version :

```bash theme={null}
curl https://lekalao.example.com/api/v1/openapi.json -o lekalao-openapi.json
```

Importez-le dans Postman ou Insomnia, ou générez un client :

```bash theme={null}
npx @openapitools/openapi-generator-cli generate \
  -i lekalao-openapi.json -g typescript-fetch -o ./lekalao-client
```

Le document publié ici est rédigé en français et plus détaillé ; celui de l'installation suit exactement ses routes.