Libris Translate 0.28.0 · Guide utilisateur
Jetons d’API et permissions
Donnez à un script ou à un assistant exactement les opérations dont il a besoin, rien de plus.
Parcours
- Ouvrez Mon compte › Jetons d’API et cliquez sur « Créer un jeton ». Donnez-lui un nom, cochez ses « Permissions » et choisissez une « Expiration », ou aucune.
- Ne cochez que ce dont le client a besoin parmi les neuf permissions : Lire les séries, Envoyer du contenu, Lancer le pipeline, Suivre les travaux, Piloter les travaux (pause, reprise, annulation), Lire les résultats et, pour le MCP, Lire la bibliothèque, Modifier la bibliothèque et Supprimer dans la bibliothèque.
- Si besoin, bornez le jeton : priorité maximale, travaux simultanés et requêtes en attente, et un budget par mois ou sur toute sa vie. Cochez « Signer les webhooks avec un secret propre à ce jeton » si ses requêtes nommeront un callback_url.
- Copiez le secret dès qu’il apparaît, car il ne sera plus jamais affiché, et rangez-le dans le gestionnaire de secrets de votre client. Les clients l’envoient comme jeton Bearer à l’API d’automatisation (/api/v1) et au serveur MCP (/mcp).
- Une fois la tâche finie, cliquez sur « Révoquer » : les clients qui utilisent le jeton reçoivent alors une erreur 401. Un jeton révoqué peut ensuite être supprimé de la liste, et ce qu’il a fait reste au journal.
À savoir
Un jeton agit au nom du compte qui l’a créé, dans les limites des droits de ce compte, et ne permet pas de se connecter à l’interface ; à l’inverse, la session web n’ouvre pas l’API d’automatisation. Chaque jeton est limité à 120 requêtes par minute par défaut, et un compte détient au plus 50 jetons non révoqués. Au-delà de sa limite de requêtes en attente, une requête est refusée avec le code HTTP 429 ; au-delà de son budget, une requête qui lancerait du travail reçoit le code HTTP 402. Un livre est compté dès son ajout : celui qui ne tient pas dans ce qui reste du quota de la licence plus la marge est refusé en entier avec le code HTTP 402 (licence_quota_insufficient, ou allowance_insufficient pour le quota propre du compte), et rien n’est importé. L’API d’automatisation et le serveur MCP sont compris dans les formules Studio et Pro : avec l’essai ou la formule Personnelle, aucun jeton ne peut être créé et un jeton valide reçoit le code HTTP 402 (automation_not_licensed) ; les jetons existants sont conservés et refonctionnent dès que la licence comprend l’API. Lancer le pipeline est la permission qui dépense : laissez-la de côté pour tout jeton qui ne doit que lire.
Exemple fictif
Donnez à un assistant de suivi fictif un jeton limité à Lire les séries, Suivre les travaux et Lire les résultats, valable 30 jours, et gardez Lancer le pipeline pour le script qui envoie les livres.