api.transglot.ai/v1jeton bearer, un projetréférence

Envoyez un fichier. Récupérez toutes les langues.

Une API REST pour traduire votre application. Un POST télécharge le fichier source, un GET renvoie une langue finalisée, et un jeton bearer constitue l'ensemble de l'authentification. Tout outil parlant HTTP peut l'utiliser.

en : un appel

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

sortie

300,000

mots par mois sur Starter, le premier plan permettant de générer un jeton.

Commencer gratuitement Voir la documentation développeur

60 requêtes par minute par jeton · chaque erreur 429 inclut un en-tête Retry-After · utilisez des jetons distincts pour la CI et la production

la console est un client API

Envoyez, traduisez, validez et récupérez, chacun étant un point de terminaison REST.

Chaque ligne de l'image ci-dessous correspond à une route : envoi, validations, glossaire, lots et récupération, toutes accessibles depuis votre propre code avec un jeton de projet. L'environnement de test API de la console exécute les opérations en lecture seule en direct sur votre projet, afin que vous puissiez voir une réponse réelle en premier.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Vous téléchargez un fichier source
POST/v1/push
Le panneau de validation se remplit
POST/v1/qa/run
Vous verrouillez un terme
POST/v1/glossary
La vue des lots s'actualise automatiquement
GET/v1/batches/:id
Vous récupérez les traductions
GET/v1/pull

une route par panneau, 60 par minute, capacités par jeton · la récupération de vos traductions est également un point de terminaison

c'est juste du HTTP

Quatre éléments que les équipes développent en premier.

chacun consiste en un seul point de terminaison et un jeton de projet · aucun ne prend tout un après-midi

porte de fusion · un seul fichier de workflow

Rejetez la pull request lorsqu'une traduction échoue.

cron · nightly

Traduisez les notes de version chaque nuit.

bot · un abonnement

Publiez sur Slack dès qu’un lot est terminé.

agent · mcp

Offrez à un agent IA les mêmes 17 outils que vous.

requêtes par minute

par jeton, et non par compte, avec un en-tête Retry-After sur chaque réponse 429 indiquant le nombre de secondes d’attente.

formats de fichiers

importez et exportez dans le format déjà utilisé par votre dépôt. Les pluriels et les espaces réservés sont conservés dans les deux sens. Spécifiez-le avec format= lors de chaque appel.

événements webhook

le catalogue complet, chacun avec un exemple de charge utile correspondant exactement au format d’une livraison réelle. GET /v1/webhooks/events.

outils mcp

le même jeton de projet, transmis à un runtime d’agent au lieu de curl. npx -y @transglot/mcp.

FAQ

Ce que les développeurs demandent avant la première requête.

Comment s’authentifier auprès de l’API Transglot ?

Envoyez un jeton bearer : Authorization: Bearer $TRANSGLOT_TOKEN. Le jeton appartient à un projet, il n’y a donc pas d’ID de projet dans le chemin ni de clé globale au compte susceptible d’être exposée. Vous créez des jetons sur la page du projet et chacun possède ses propres capacités : push, pull, manage, read, write.

L’API est-elle gratuite ?

Non. Un jeton bearer commence avec le plan Starter à 19 $ par mois. La version gratuite couvre la console, ce qui suffit pour vérifier si le produit convient, mais elle ne permet pas de générer un jeton. La CLI, l’action GitHub, les webhooks, MCP et le bundle de livraison reposent tous sur ce même jeton, ils sont donc inclus ensemble.

Comment importer des chaînes dans Transglot ?

POST /v1/push avec le fichier et son format, par exemple -F "file=@lang/en.json" -F "format=laravel_json". La réponse est 202 et met un lot en file d’attente. Seules les lignes ayant réellement changé sont traduites, donc envoyer un fichier inchangé ne coûte rien.

Comment récupérer mes traductions ?

GET /v1/pull, dans l’un des 20 formats, quand vous le souhaitez. C’est le point de terminaison encapsulé par la CLI et celui exécuté en direct par l’aire de jeu de l’API. Il n’y a pas de demande d’exportation à déposer ni de période pendant laquelle les données cessent de vous appartenir.

Quelle est la limite de débit de l’API ?

60 requêtes par minute, comptées par jeton plutôt que par compte. Au-delà, vous recevez une erreur 429 avec un en-tête Retry-After indiquant le nombre de secondes d’attente, et rien n’est facturé ni écrit partiellement. Utilisez des jetons distincts pour l’intégration continue et la production afin qu’un build bruyant n’affame pas votre application.

Quelles langues l’API prend-elle en charge ?

Il n’y a pas de liste fixe. Le validateur accepte toute balise BCP-47 reconnue par ICU, soit 708 locales dans la table de référence, plus un repli structurel pour les balises hors liste. Ajoutez une locale au projet et le prochain push l’inclura.

Quels formats de fichier puis-je importer et exporter ?

Vingt : JSON plat et imbriqué, Laravel PHP et JSON, Android XML, iOS .strings, .stringsdict et .xcstrings, Flutter ARB, XLIFF 1.2 et 2.0, gettext .po, YAML, CSV, XLSX, propriétés Java, RESX, Markdown, Unity CSV et Unreal PO. Sept d’entre eux gèrent les pluriels, et le fichier revient dans la même structure qu’à l’envoi.

Transglot propose-t-il des webhooks ?

Oui. Il existe 12 événements webhook, dont batch.completed, translation.reviewed, qa.completed et source_drift.repaired. Chaque livraison est signée HMAC avec un en-tête d’horodatage pour vérification, et GET /v1/webhooks/events renvoie le catalogue avec un exemple de charge utile pour chacun.

Existe-t-il un serveur MCP pour les agents IA ?

Oui. npx -y @transglot/mcp expose 17 outils via votre jeton de projet, permettant à un assistant de lire une traduction, d’en écrire une, d’ajouter une langue, de lancer une exécution, de vérifier un lot ou de modifier le glossaire. Il s’agit de la même API et des mêmes autorisations, accessibles depuis un environnement d’exécution d’agent plutôt que via curl.

Puis-je l'exécuter dans une CI ?

Oui. L’action GitHub (transglot/transglot-action@v1) et l’interface en ligne de commande encapsulent toutes deux ces points de terminaison. Lorsqu’une ligne est refusée, transglot push --wait se termine avec le code 4 et l’action échoue pour cette exécution. Pour bloquer une fusion, exécutez-la sur les demandes de tirage avec son entrée de commit définie sur none, ajoutez une étape qui échoue lorsqu’il manque une clé dans un fichier extrait, et configurez le job comme une vérification obligatoire dans la protection des branches.

Que se passe-t-il lorsqu'une traduction échoue à un contrôle de qualité ?

Quatre portes déterministes analysent chaque ligne : espaces réservés, pluriels, termes du glossaire et longueur. Un espace réservé incorrect, une forme plurielle manquante ou un terme de glossaire interdit déclenche une tentative de correction automatique ; si elle échoue encore, la ligne est refusée au lieu d’être écrite. Une ligne qui dépasse uniquement sa limite de longueur est écrite, pas refusée. GET /v1/batches/:id?include=failures liste les lignes refusées et les raisons.

L'API va-t-elle un jour rompre mon intégration ?

Non. /v1 ne fait qu'ajouter des points de terminaison et des champs de réponse ; un champ que vous analysez déjà ne change ni de forme ni ne disparaît. Un changement incompatible serait publié sous un nouveau préfixe de version, qui est réservé et encore vide. Le journal des modifications de l'API enregistre chaque version.