AI Glot websiteOpen AI Glot
API RESTAuthentification et portées

Authentification et portées

Authentifiez les requêtes de l’API AI Glot avec des clés d’espace de travail ou des jetons OAuth, choisissez les portées minimales et renouvelez les identifiants sans exposer de secrets.

Envoyez une clé API d’espace de travail ou un jeton d’accès OAuth comme identifiant Bearer :

Authorization header
Authorization: Bearer aig_live_••••••••

Ne placez jamais un identifiant dans une chaîne de requête. Les URL sont copiées dans les journaux, l’historique du navigateur et les en-têtes de référent.

Clés API d’espace de travail

Un administrateur crée les clés dans Outils de développement, sous l’onglet API. Le secret complet ne s’affiche qu’une fois ; AI Glot ne conserve qu’un hachage protégé. Un espace de travail peut compter jusqu’à 10 clés actives.

Boîte de dialogue de création d’une clé API avec un nom, un préréglage d’autorisations, une date d’expiration et un bouton Create key

Créez une clé nommée et choisissez ses autorisations
  1. Nom. Indiquez l’intégration qui utilisera la clé, par exemple le travail CI ou le service concerné. Créez une clé distincte et nommée pour chaque intégration.
  2. Autorisations. Choisissez un préréglage : Lecture seule, Gestionnaire de glossaires ou Accès complet. Ouvrez Avancé pour sélectionner les portées individuellement. Commencez par l’ensemble minimal dont l’intégration a besoin.
  3. Expiration. Choisissez Aucune expiration, ou une expiration dans 30, 90 ou 365 jours.
  4. Créer une clé. Le secret complet s’affiche une seule fois, juste après sa création. Copiez-le à ce moment-là : vous ne pourrez plus le consulter.

Renouveler une clé

La liste des clés propose l’action Renouveler. Elle crée une clé de remplacement portant le même nom et conservant les mêmes portées et la même expiration, puis révoque l’originale au cours de la même opération. L’ancienne clé cesse immédiatement de fonctionner. Elle est marquée replaced plutôt que simplement révoquée, et la clé qui lui succède est indiquée.

C’est intentionnel : vous renouvelez une clé parce qu’un secret est peut-être compromis. Une clé qui reste valide une heure de plus reste également utilisable par la personne qui l’a dérobée. Pour une transition planifiée sans interruption de service, créez plutôt une deuxième clé, basculez l’intégration sur celle-ci, vérifiez que l’ancienne n’est plus utilisée, puis révoquez-la.

Jetons OAuth

La CLI et les clients MCP compatibles peuvent utiliser OAuth 2.1. OAuth est recommandé pour les personnes : la connexion indique qui l’a approuvée et respecte le plafond d’accès de ce membre. Les clés API restent adaptées aux tâches CI et aux services backend.

Portées

Les portées suivantes sont actuellement disponibles :

PortéeAutorisation
account:readIdentité de l’espace de travail, forfait, fonctionnalités, limites et récapitulatif des crédits
usage:readTotaux d’utilisation et périodes de consommation
batches:readLister les traductions, consulter leur avancement et télécharger les résultats terminés
batches:createCréer une traduction, la planifier et l’approuver. L’approbation consomme les crédits de l’espace de travail
batches:writeRenommer et archiver des traductions, et annuler celles en cours. L’annulation est facturée en fonction du travail déjà effectué
glossaries:readLister et consulter les glossaires
glossaries:writeCréer, mettre à jour, remplacer ou supprimer des glossaires

Une portée manquante entraîne la réponse 403 insufficient_scope.

Portée réservée

Une autre portée peut être accordée dès aujourd’hui, mais aucun point de terminaison ne la prend encore en charge. Elle apparaît à l’écran de consentement OAuth et dans le préréglage Accès complet du tableau de bord. Nous la documentons donc ici plutôt que de la masquer : toute autorisation soumise à votre approbation doit pouvoir être retrouvée dans la documentation de référence.

PortéeAutorisation prévueÉtat
webhooks:writeCréer, modifier et supprimer les webhooks qui avertissent vos systèmes lorsque les tâches sont terminéesPas encore disponible

Cette portée est définie à l’avance pour qu’un identifiant accordé aujourd’hui reste valide lorsque la fonctionnalité sera lancée, sans nécessiter une nouvelle approbation. Pour déterminer ce qu’un identifiant peut réellement faire, consultez capabilities dans GET /v1/account, plutôt que les portées accordées. Une portée peut être accordée avant l’existence du point de terminaison correspondant. L’envoi d’un fichier ne nécessite aucune portée dédiée : les fichiers sont transmis avec l’appel de création, sous batches:create.

Limite d’accès des membres

Les administrateurs d’un espace de travail peuvent limiter l’accès des membres aux outils de développement. Un client OAuth reçoit l’intersection entre les portées demandées et celles auxquelles le membre qui l’approuve a accès. Une nouvelle connexion avec une demande plus étendue ne permet pas de contourner une limite en lecture seule.

Par défaut, les limites d’accès des membres des nouveaux espaces de travail comprennent toutes les portées, y compris batches:create. Un membre peut déjà lancer une traduction dans l’application web ; la limite correspond donc à ce qu’il peut y faire. Les espaces de travail créés avant le 31 août 2026 conservent leur limite actuelle, qui exclut batches:create. Cette portée étant la seule à consommer des crédits, son attribution doit être mûrement réfléchie : un agent exécutant une boucle avec un identifiant délégué pourrait épuiser le budget mensuel avant que quiconque ne s’en aperçoive, et les crédits consommés ne peuvent pas être récupérés. Un administrateur peut décocher cette portée, ou toute autre, dans l’onglet Autorisations des Outils de développement, ou pour une personne donnée depuis la page Équipe.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.