mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
1876c01f16
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
60 lines
4.2 KiB
Plaintext
60 lines
4.2 KiB
Plaintext
---
|
||
title: "Introduction"
|
||
description: "Déclenchez des mises à jour, intégrez l’Assistant IA, et plus encore"
|
||
keywords: ["REST API", "endpoints", "API keys"]
|
||
---
|
||
|
||
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.
|
||
|
||
<div id="endpoints">
|
||
## Points de terminaison
|
||
</div>
|
||
|
||
* [Déclencher une mise à jour](/fr/api-reference/update/trigger) : Déclenchez une mise à jour de votre site lorsque vous le souhaitez.
|
||
* [Obtenir l’état de la mise à jour](/fr/api-reference/update/status) : Obtenez l’état d’une mise à jour et d’autres détails sur votre documentation.
|
||
* [Créer une tâche d’agent](/fr/api-reference/agent/create-agent-job) : Créez une tâche d’agent pour modifier automatiquement votre documentation.
|
||
* [Obtenir une tâche d’agent](/fr/api-reference/agent/get-agent-job) : Récupérez les détails et l’état d’une tâche d’agent spécifique.
|
||
* [Obtenir toutes les tâches d’agent](/fr/api-reference/agent/get-all-jobs) : Récupérez toutes les tâches d’agent pour un domain.
|
||
* [Générer un message de l’Assistant](/fr/api-reference/assistant/create-assistant-message) : Intégrez l’Assistant, entraîné sur votre documentation, dans n’importe quelle application de votre choix.
|
||
* [Rechercher dans la documentation](/fr/api-reference/assistant/search) : Recherchez dans votre documentation.
|
||
|
||
<div id="common-use-cases">
|
||
### Cas d’usage courants
|
||
</div>
|
||
|
||
* **Déploiements automatisés** : Déclenchez les mises à jour du site à intervalles définis ou lors d’événements spécifiques avec [Trigger update](/fr/api-reference/update/trigger) et [Get update status](/fr/api-reference/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-reference/update/trigger).
|
||
* **Intégrations personnalisées** : Intégrez l’Assistant IA dans votre produit, votre portail d’assistance ou vos outils internes avec [Generate assistant message](/fr/api-reference/assistant/create-assistant-message) et [Search documentation](/fr/api-reference/assistant/search).
|
||
* **É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](/fr/api-reference/agent/create-agent-job), [Get agent job](/fr/api-reference/agent/get-agent-job), et [Get all agent jobs](/fr/api-reference/agent/get-all-jobs).
|
||
|
||
<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 [déclencher une mise à jour](/fr/api-reference/update/trigger), [obtenir l’état de la mise à jour](/fr/api-reference/update/status) 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.
|
||
|
||
<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 [Générer un message de l’assistant](/fr/api-reference/assistant/create-assistant-message) et [Rechercher dans la documentation](/fr/api-reference/assistant/search).
|
||
|
||
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> |