Passer au contenu principal
L’API REST de Mintlify vous permet d’interagir programmatiquement avec votre documentation, de déclencher des mises à jour et d’intégrer des expériences de chat propulsées par l’IA.

Points de terminaison

Cas d’usage courants

  • Déploiements automatisés : Déclenchez les mises à jour du site à intervalles définis ou lors d’événements spécifiques avec Trigger update et Get update status.
  • Intégration CI/CD : Mettez à jour la documentation dans le cadre de votre pipeline de déploiement lorsque le code change avec Trigger update.
  • Intégrations personnalisées : Intégrez l’Assistant IA dans votre produit, votre portail d’assistance ou vos outils internes avec Generate assistant message et Search documentation.
  • Édition automatisée : Utilisez des tâches d’agent pour mettre à jour la documentation de manière programmatique et à grande échelle avec Create agent job, Get agent job, et Get all agent jobs.

Authentification

Générez des clés d’API depuis la page API keys de votre Dashboard. Les clés d’API sont associées à toute l’organisation et peuvent être utilisées sur plusieurs déploiements au sein de la même organisation. Vous pouvez créer jusqu’à 10 clés d’API par heure et par organisation.

Clé d’API administrateur

Utilisez la clé d’API administrateur pour authentifier les requêtes vers déclencher une mise à jour, obtenir l’état de la mise à jour et tous les points de terminaison de l’agent. Les clés d’API administrateur commencent par le préfixe mint_. Gardez vos clés d’API administrateur confidentielles. La clé d’API administrateur est un jeton côté serveur. Gardez-la secrète.

Clé d’API de l’Assistant

Utilisez la clé d’API de l’Assistant pour authentifier les requêtes vers les points de terminaison Générer un message de l’assistant et Rechercher dans la documentation. Les clés d’API de l’Assistant commencent par le préfixe mint_dsc_. La clé d’API de l’Assistant est un jeton public qui peut être référencé dans votre code front-end.
Les appels utilisant le token de l’API de l’Assistant peuvent entraîner des coûts : soit en utilisant vos crédits d’Assistant, soit en engendrant des dépassements.