mintlify__docs/fr/api/introduction.mdx

---
title: "Introduction"
description: "Utilisez l'API REST de Mintlify pour déclencher des déploiements, intégrer un assistant IA, exporter des données d'analyse et gérer la documentation de manière programmatique."
keywords: ["REST API", "endpoints", "API keys"]
boost: 3
---

L'API REST (Representational State Transfer) de Mintlify vous permet d'interagir programmatiquement avec votre documentation, de déclencher des mises à jour, d'intégrer des expériences de chat propulsées par l'IA et d'exporter les données d'analyse.

<div id="endpoints">
  ## Endpoints
</div>

- [Trigger update](/fr/api/admin/trigger-update): Déclenchez une mise à jour de votre site quand vous le souhaitez.
- [Get update status](/fr/api/admin/get-update-status): Récupérez le statut d'une mise à jour et d'autres détails sur votre documentation.
- [Trigger preview deployment](/fr/api/admin/trigger-preview-deployment): Créez ou mettez à jour un déploiement de prévisualisation pour une branche spécifique.
- [Create agent job](/fr/api/agent/create-agent-job): Créez une tâche d'agent pour modifier automatiquement votre documentation.
- [Get agent job](/fr/api/agent/get-agent-job): Récupérez les détails et le statut d'une tâche d'agent spécifique.
- [Send follow-up message](/fr/api/agent/send-follow-up-message): Envoyez un message de suivi à une tâche d'agent existante.
- [Create assistant message](/fr/api/assistant/create-assistant-message): Intégrez l'Assistant, entraîné sur votre documentation, dans n'importe quelle application de votre choix.
- [Search documentation](/fr/api/assistant/search-documentation): Effectuez une recherche dans votre documentation.
- [Get page content](/fr/api/assistant/get-page-content): Récupérez le contenu textuel complet d'une page de documentation.
- [Get user feedback](/fr/api/analytics/get-feedback): Exportez les retours utilisateurs issus de votre documentation.
- [Get assistant conversations](/fr/api/analytics/get-assistant-conversations): Exportez l'historique des conversations de l'Assistant IA.
- [Get assistant caller stats](/fr/api/analytics/get-assistant-caller-stats): Récupérez une ventilation du nombre de requêtes de l'assistant par type d'appelant.

<div id="common-use-cases">
  ### Cas d'utilisation courants
</div>

- **Déploiements automatisés** : Déclenchez les mises à jour du site à intervalles réguliers ou lorsqu'un événement se produit avec [Trigger update](/fr/api/admin/trigger-update) et [Get update status](/fr/api/admin/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](/fr/api/admin/trigger-update).
- **Déploiements de prévisualisation** : Créez ou mettez à jour des déploiements de prévisualisation de manière programmatique dans votre pipeline CI/CD avec [Trigger preview deployment](/fr/api/admin/trigger-preview-deployment).
- **Intégrations personnalisées** : Intégrez l'Assistant IA à votre produit, portail d'assistance ou outils internes avec [Create assistant message](/fr/api/assistant/create-assistant-message), [Search documentation](/fr/api/assistant/search-documentation) et [Get page content](/fr/api/assistant/get-page-content).
- **Édition automatisée** : Utilisez des jobs d'agent pour mettre à jour la documentation de manière programmatique et à grande échelle avec [Create agent job](/fr/api/agent/create-agent-job), [Get agent job](/fr/api/agent/get-agent-job), et [Send follow-up message](/fr/api/agent/send-follow-up-message).
- **Export Analytics** : Exportez les retours utilisateurs, les conversations de l'Assistant et les données de visiteurs pour une analyse externe avec [Get user feedback](/fr/api/analytics/get-feedback), [Get assistant conversations](/fr/api/analytics/get-assistant-conversations) et [Get assistant caller stats](/fr/api/analytics/get-assistant-caller-stats).

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

Générez des clés d'API depuis la [page API keys](https://dashboard.mintlify.com/settings/organization/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.

<div id="admin-api-key">
  ### Clé d'API administrateur
</div>

Utilisez la clé d'API administrateur pour authentifier les requêtes vers [Trigger update](/fr/api/admin/trigger-update), [Get update status](/fr/api/admin/get-update-status), [Trigger preview deployment](/fr/api/admin/trigger-preview-deployment), [Create agent job](/fr/api/agent/create-agent-job), [Get agent job](/fr/api/agent/get-agent-job), [Send follow-up message](/fr/api/agent/send-follow-up-message), [Get user feedback](/fr/api/analytics/get-feedback), [Get assistant conversations](/fr/api/analytics/get-assistant-conversations) et [Get assistant caller stats](/fr/api/analytics/get-assistant-caller-stats).

Les clés d'API administrateur commencent par le préfixe `mint_`.

La clé d'API administrateur est un secret côté serveur. Ne l'exposez pas dans du code côté client.

<div id="assistant-api-key">
  ### Clé d'API de l'Assistant
</div>

Utilisez la clé d'API de l'Assistant pour authentifier les requêtes vers les points de terminaison [Create assistant message](/fr/api/assistant/create-assistant-message), [Search documentation](/fr/api/assistant/search-documentation) et [Get page content](/fr/api/assistant/get-page-content).

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.

<Note>
  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.
</Note>