# API REST Mintlify Index (/fr/api/search-index/introduction)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 909 · updated: 2026-09-23 -->
Related: [Construire le contexte d’implémentation](/fr/api/search-index/context.md), [Rechercher des connaissances techniques](/fr/api/search-index/search.md), [Obtenir le contenu des résultats](/fr/api/search-index/contents.md), [Obtenir le contenu de la page](/fr/api/assistant/get-page-content.md)

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`](/fr/api/search-index/context) assemble du contenu accompagné de ses sources dans une limite de jetons.
* [`search`](/fr/api/search-index/search) renvoie des résultats classés issus de la documentation et du web.
* [`contents`](/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](/fr/search-index/mcp) ne nécessite pas de clé d’API.
</Info>

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

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

```text
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 [#authentification]
</div>

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

```http
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.
  </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
    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
    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 [#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 [#erreurs]
</div>

| Statut | Signification                                                    |
| ------ | ---------------------------------------------------------------- |
| `400`  | Le corps de la requête n’est pas valide.                         |
| `401`  | La clé d’API est absente ou invalide.                            |
| `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.                            |