API REST Mintlify Index

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 assemble du contenu accompagné de ses sources dans une limite de jetons.
• search renvoie des résultats classés issus de la documentation et du web.
• contents récupère le contenu correspondant aux identifiants de résultats Mintlify ou aux URL de résultats sélectionnés.

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

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.

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

Authorization: Bearer mint_us_...

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

export MINTLIFY_INDEX_API_KEY="mint_us_..."

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
  }'

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 :

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.