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

# API REST Mintlify Index

> Utilisez l’API REST Mintlify Index pour rechercher dans la documentation et sur le web, assembler un contexte accompagné de sources et récupérer le contenu de pages pour vos applications et agents.

Utilisez l’API REST Mintlify Index pour récupérer des connaissances techniques pour vos applications et agents. L’API prend en charge trois modes de récupération :

* [`context`](/docs/fr/api/search-index/context) assemble du contenu accompagné de ses sources dans une limite de jetons.
* [`search`](/docs/fr/api/search-index/search) renvoie des résultats classés issus de la documentation et du web.
* [`contents`](/docs/fr/api/search-index/contents) récupère le contenu correspondant aux identifiants de résultats Mintlify ou aux URL de résultats sélectionnés.

<Info>
  L’API REST nécessite une clé d’API pour votre organisation. Le [serveur MCP Index public](/docs/fr/search-index/mcp) ne nécessite pas de clé d’API.
</Info>

<div id="base-url">
  ## URL de base
</div>

Envoyez les requêtes de l’API REST à l’adresse suivante :

```text theme={null}
https://leaves.mintlify.com/api/universal-search/v1
```

Ajoutez un chemin de point de terminaison à cette URL de base, par exemple `/context`, `/search` ou `/contents`.

<div id="authentication">
  ## Authentification
</div>

Authentifiez chaque requête avec une clé d’API Index dans l’en-tête `Authorization` :

```http theme={null}
Authorization: Bearer mint_us_...
```

Les clés d’API Index commencent par `mint_us_`.

<Steps>
  <Step title="Créer une clé d’API Index">
    Ouvrez la [page des clés d’API](https://app.mintlify.com/settings/organization/api-keys) dans votre tableau de bord et créez une clé d’API Index.

    Si ce type de clé n’est pas disponible, votre organisation n’a pas accès à l’API REST Index.
  </Step>

  <Step title="Stocker la clé en toute sécurité">
    Enregistrez la clé dans une variable d’environnement côté serveur. Mintlify n’affiche la clé complète qu’au moment de sa création. Stockez-la en lieu sûr.

    ```bash theme={null}
    export MINTLIFY_INDEX_API_KEY="mint_us_..."
    ```

    <Warning>
      N’exposez pas une clé d’API Index dans du code côté client et ne la validez pas dans le contrôle de version.
    </Warning>
  </Step>

  <Step title="Construire le contexte">
    Envoyez votre première requête au point de terminaison `context` :

    ```bash theme={null}
    curl -X POST "https://leaves.mintlify.com/api/universal-search/v1/context" \
      -H "Authorization: Bearer $MINTLIFY_INDEX_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "query": "How should I configure caching in Next.js 16?",
        "product": "Next.js",
        "format": "txt",
        "tokenBudget": 3000
      }'
    ```

    Une réponse réussie inclut le contexte assemblé avec les URL sources, le nombre de résultats utilisés et le nombre de jetons générés.
  </Step>
</Steps>

<div id="rate-limits">
  ## Limites de débit
</div>

Les limites de l’API REST s’appliquent à chaque organisation Mintlify. Toutes les clés d’API d’une organisation partagent la même limite :

| Fenêtre     |         Limite |
| ----------- | -------------: |
| Par seconde |    10 requêtes |
| Par jour    | 1 000 requêtes |

Les requêtes dépassant l’une ou l’autre limite renvoient `429 Too Many Requests`. Utilisez un back-off exponentiel avant de réessayer.

<div id="errors">
  ## Erreurs
</div>

| Statut | Signification                                                                             |
| ------ | ----------------------------------------------------------------------------------------- |
| `400`  | Le corps de la requête n’est pas valide.                                                  |
| `401`  | La clé d’API est absente ou invalide, ou l’organisation n’a pas accès à l’API REST Index. |
| `403`  | L’adresse IP de la requête n’est pas autorisée par la clé d’API.                          |
| `429`  | L’organisation a dépassé une limite de débit.                                             |
| `500`  | Index n’a pas pu terminer la requête.                                                     |


## Related topics

- [Introduction à l'API REST Mintlify](/docs/fr/api/introduction.md)
- [llms.txt](/docs/fr/ai/llmstxt.md)
- [Mintlify Index](/docs/fr/search-index/index.md)