Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions es/api/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,10 +12,10 @@ La REST API de Mintlify te permite interactuar de forma programática con tu doc

* [Trigger update](/es/api/update/trigger): Activa una actualización de tu sitio cuando quieras.
* [Get update status](/es/api/update/status): Obtén el estado de una actualización y otros detalles de tu documentación.
* [Create agent job](/es/api/agent/create-agent-job): Crea una tarea de agente para editar tu documentación automáticamente.
* [Get agent job](/es/api/agent/get-agent-job): Obtén los detalles y el estado de una tarea de agente específica.
* [Get all agent jobs](/es/api/agent/get-all-jobs): Obtén todas las tareas de agente para un domain.
* [Generate assistant message](/es/api/assistant/create-assistant-message): Integra el assistant, entrenado con tu documentación, en cualquier aplicación que elijas.
* [Create agent job](/es/api/agent/v2/create-agent-job): Crea una tarea de agente para editar tu documentación automáticamente.
* [Get agent job](/es/api/agent/v2/get-agent-job): Obtén los detalles y el estado de una tarea de agente específica.
* [Send follow-up message](/es/api/agent/v2/send-message): Envía un mensaje de seguimiento a una tarea de agente existente.
* [Create assistant message](/es/api/assistant/create-assistant-message-v2): Integra el assistant, entrenado con tu documentación, en cualquier aplicación que elijas.
* [Search documentation](/es/api/assistant/search): Busca en tu documentación.
* [Get user feedback](/es/api/analytics/feedback): Exporta los comentarios de los usuarios de tu documentación.
* [Get assistant conversations](/es/api/analytics/assistant-conversations): Exporta el historial de conversaciones del Asistente de IA.
Expand All @@ -26,8 +26,8 @@ La REST API de Mintlify te permite interactuar de forma programática con tu doc

* **Implementaciones automatizadas**: Activa actualizaciones del sitio a intervalos establecidos o cuando se produzcan eventos con [Trigger update](/es/api/update/trigger) y [Get update status](/es/api/update/status).
* **Integración CI/CD**: Actualiza la documentación como parte de tu pipeline de implementación cuando el código cambie con [Trigger update](/es/api/update/trigger).
* **Integraciones personalizadas**: Inserta el Asistente de IA en tu producto, portal de soporte o herramientas internas con [Generate assistant message](/es/api/assistant/create-assistant-message) y [Search documentation](/es/api/assistant/search).
* **Edición automatizada**: Usa trabajos de agente para actualizar la documentación programáticamente y a escala con [Create agent job](/es/api/agent/create-agent-job), [Get agent job](/es/api/agent/get-agent-job) y [Get all agent jobs](/es/api/agent/get-all-jobs).
* **Integraciones personalizadas**: Inserta el Asistente de IA en tu producto, portal de soporte o herramientas internas con [Create assistant message](/es/api/assistant/create-assistant-message-v2) y [Search documentation](/es/api/assistant/search).
* **Edición automatizada**: Usa trabajos de agente para actualizar la documentación programáticamente y a escala con [Create agent job](/es/api/agent/v2/create-agent-job), [Get agent job](/es/api/agent/v2/get-agent-job) y [Send follow-up message](/es/api/agent/v2/send-message).
* **Exportación de Analytics**: Exporta comentarios y conversaciones del Asistente de IA para análisis externo con [Get user feedback](/es/api/analytics/feedback) y [Get assistant conversations](/es/api/analytics/assistant-conversations).

<div id="authentication">
Expand All @@ -42,7 +42,7 @@ Puedes crear hasta 10 API keys por hora y por organización.
### Clave de la API de administrador
</div>

Usa la clave de la API de administrador para autenticar solicitudes a [Activar actualización](/es/api/update/trigger), [Obtener estado de la actualización](/es/api/update/status), [Crear tarea de agente](/es/api/agent/create-agent-job), [Obtener tarea de agente](/es/api/agent/get-agent-job), [Obtener todas las tareas de agente](/es/api/agent/get-all-jobs), [Obtener comentarios de los usuarios](/es/api/analytics/feedback) y [Obtener conversaciones del assistant](/es/api/analytics/assistant-conversations).
Usa la clave de la API de administrador para autenticar solicitudes a [Trigger update](/es/api/update/trigger), [Get update status](/es/api/update/status), [Create agent job](/es/api/agent/v2/create-agent-job), [Get agent job](/es/api/agent/v2/get-agent-job), [Send follow-up message](/es/api/agent/v2/send-message), [Get user feedback](/es/api/analytics/feedback) y [Get assistant conversations](/es/api/analytics/assistant-conversations).

Las claves de la API de administrador comienzan con el prefijo `mint_`.

Expand All @@ -52,12 +52,12 @@ La clave de la API de administrador es un secreto del lado del servidor. No la e
### key del Assistant API
</div>

Usa la key del Assistant API para autenticar solicitudes a los endpoints [Generate assistant message](/es/api/assistant/create-assistant-message) y [Search documentation](/es/api/assistant/search).
Usa la key del Assistant API para autenticar solicitudes a los endpoints [Create assistant message](/es/api/assistant/create-assistant-message-v2) y [Search documentation](/es/api/assistant/search).

Las keys del Assistant API comienzan con el prefijo `mint_dsc_`.

La key del Assistant API es un token público que puede referenciarse en tu código de frontend.

<Note>
Las llamadas que usan el token del Assistant API pueden generar costos: ya sea usando tus créditos del assistant o incurriendo en excedentes.
</Note>
</Note>
2 changes: 1 addition & 1 deletion es/organize/pages.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Usa el frontmatter para controlar:
</ResponseField>

<ResponseField name="groups" type="string[]">
Restringe la página a usuarios de grupos específicos. Los usuarios deben pertenecer a al menos uno de los grupos indicados para acceder a la página. Se debe configurar la [autenticación](/es/deploy/authentication-setup). Consulta [Controlar el acceso con grupos](/es/deploy/authentication-setup#control-access-with-groups) para más información.
Restringe la página a usuarios en grupos específicos. Los usuarios deben pertenecer a al menos uno de los grupos listados para acceder a la página. Se debe configurar la [autenticación](/es/deploy/authentication-setup). Consulta [Controlar el acceso con grupos](/es/deploy/authentication-setup#control-access-with-groups) para más información.
</ResponseField>

<ResponseField name="<custom>" type="string">
Expand Down
52 changes: 26 additions & 26 deletions fr/api/introduction.mdx
Original file line number Diff line number Diff line change
@@ -1,63 +1,63 @@
---
title: "Introduction"
description: "Déclenchez des mises à jour, intégrez lAssistant IA, exportez les données danalyse, et plus encore"
description: "Déclenchez des mises à jour, intégrez l'Assistant IA, exportez les données d'analyse, et plus encore"
keywords: ["REST API", "endpoints", "API keys"]
---

LAPI REST de Mintlify vous permet dinteragir programmatiquement avec votre documentation, de déclencher des mises à jour, dintégrer des expériences de chat propulsées par lIA et dexporter les données danalyse.
L'API REST 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/update/trigger): Déclenchez une mise à jour de votre site quand vous le souhaitez.
* [Get update status](/fr/api/update/status): Récupérez le statut dune mise à jour et dautres détails sur votre documentation.
* [Create agent job](/fr/api/agent/create-agent-job): Créez une tâche dagent pour modifier automatiquement votre documentation.
* [Get agent job](/fr/api/agent/get-agent-job): Récupérez les détails et le statut dune tâche dagent spécifique.
* [Get all agent jobs](/fr/api/agent/get-all-jobs): Récupérez toutes les tâches d’agent pour un domain.
* [Generate assistant message](/fr/api/assistant/create-assistant-message): Intégrez lAssistant, entraîné sur votre documentation, dans nimporte quelle application de votre choix.
* [Get update status](/fr/api/update/status): Récupérez le statut d'une mise à jour et d'autres détails sur votre documentation.
* [Create agent job](/fr/api/agent/v2/create-agent-job): Créez une tâche d'agent pour modifier automatiquement votre documentation.
* [Get agent job](/fr/api/agent/v2/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/v2/send-message): Envoyez un message de suivi à une tâche d'agent existante.
* [Create assistant message](/fr/api/assistant/create-assistant-message-v2): Intégrez l'Assistant, entraîné sur votre documentation, dans n'importe quelle application de votre choix.
* [Search documentation](/fr/api/assistant/search): Effectuez une recherche dans votre documentation.
* [Get user feedback](/fr/api/analytics/feedback): Exportez les retours utilisateurs issus de votre documentation.
* [Get assistant conversations](/fr/api/analytics/assistant-conversations): Exportez lhistorique des conversations de lAssistant IA.
* [Get assistant conversations](/fr/api/analytics/assistant-conversations): Exportez l'historique des conversations de l'Assistant IA.

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

* **Déploiements automatisés** : Déclenchez les mises à jour du site à intervalles réguliers ou lorsquun événement se produit avec [Trigger update](/fr/api/update/trigger) et [Get update status](/fr/api/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/update/trigger).
* **Intégrations personnalisées** : Intégrez lAssistant IA à votre produit, portail dassistance ou outils internes avec [Generate assistant message](/fr/api/assistant/create-assistant-message) et [Search documentation](/fr/api/assistant/search).
* **Édition automatisée** : Utilisez des jobs dagent 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 [Get all agent jobs](/fr/api/agent/get-all-jobs).
* **Export Analytics** : Exportez les retours utilisateurs et les conversations avec lAssistant pour une analyse externe avec [Get user feedback](/fr/api/analytics/feedback) et [Get assistant conversations](/fr/api/analytics/assistant-conversations).
* **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/update/trigger) et [Get update status](/fr/api/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/update/trigger).
* **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-v2) et [Search documentation](/fr/api/assistant/search).
* **É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/v2/create-agent-job), [Get agent job](/fr/api/agent/v2/get-agent-job), et [Send follow-up message](/fr/api/agent/v2/send-message).
* **Export Analytics** : Exportez les retours utilisateurs et les conversations avec l'Assistant pour une analyse externe avec [Get user feedback](/fr/api/analytics/feedback) et [Get assistant conversations](/fr/api/analytics/assistant-conversations).

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

Générez des clés dAPI depuis la [page API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de votre Dashboard. Les clés dAPI sont associées à toute lorganisation et peuvent être utilisées sur plusieurs déploiements au sein de la même organisation.
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 dAPI par heure et par organisation.
Vous pouvez créer jusqu'à 10 clés d'API par heure et par organisation.

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

Utilisez la clé dAPI administrateur pour authentifier les requêtes vers [déclencher une mise à jour](/fr/api/update/trigger), [obtenir l’état de la mise à jour](/fr/api/update/status), [créer une tâche d’agent](/fr/api/agent/create-agent-job), [obtenir une tâche d’agent](/fr/api/agent/get-agent-job), [obtenir toutes les tâches d’agent](/fr/api/agent/get-all-jobs), [obtenir les retours utilisateurs](/fr/api/analytics/feedback) et [obtenir les conversations de l’Assistant](/fr/api/analytics/assistant-conversations).
Utilisez la clé d'API administrateur pour authentifier les requêtes vers [Trigger update](/fr/api/update/trigger), [Get update status](/fr/api/update/status), [Create agent job](/fr/api/agent/v2/create-agent-job), [Get agent job](/fr/api/agent/v2/get-agent-job), [Send follow-up message](/fr/api/agent/v2/send-message), [Get user feedback](/fr/api/analytics/feedback) et [Get assistant conversations](/fr/api/analytics/assistant-conversations).

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

La clé dAPI administrateur est un secret côté serveur. Ne lexposez pas dans du code côté client.
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é dAPI de lAssistant
### Clé d'API de l'Assistant
</div>

Utilisez la clé dAPI de lAssistant pour authentifier les requêtes vers les points de terminaison [Générer un message de l’assistant](/fr/api/assistant/create-assistant-message) et [Rechercher dans la documentation](/fr/api/assistant/search).
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-v2) et [Search documentation](/fr/api/assistant/search).

Les clés dAPI de lAssistant commencent par le préfixe `mint_dsc_`.
Les clés d'API de l'Assistant commencent par le préfixe `mint_dsc_`.

La clé dAPI de lAssistant est un jeton public qui peut être référencé dans votre code front-end.
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 lAPI de lAssistant peuvent entraîner des coûts : soit en utilisant vos crédits dAssistant, soit en engendrant des dépassements.
</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>
2 changes: 1 addition & 1 deletion fr/organize/pages.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Utilisez le frontmatter pour contrôler :
</ResponseField>

<ResponseField name="groups" type="string[]">
Restreindre la page aux utilisateurs appartenant à des groupes spécifiques. Les utilisateurs doivent appartenir à au moins un des groupes listés pour accéder à la page. L'[authentification](/fr/deploy/authentication-setup) doit être configurée. Voir [Contrôler l'accès avec les groupes](/fr/deploy/authentication-setup#control-access-with-groups) pour plus d'informations.
Restreint la page aux utilisateurs appartenant à des groupes spécifiques. Les utilisateurs doivent appartenir à au moins un des groupes listés pour accéder à la page. L'[authentification](/fr/deploy/authentication-setup) doit être configurée. Voir [Contrôler l'accès avec des groupes](/fr/deploy/authentication-setup#control-access-with-groups) pour plus d'informations.
</ResponseField>

<ResponseField name="<custom>" type="string">
Expand Down
Loading
Loading