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

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

Une API REST pour traduire votre application. Un POST téléverse le fichier source, un GET renvoie une locale terminée, et un jeton bearer constitue l’ensemble de l’authentification. Tout ce qui parle HTTP peut la piloter.

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 le forfait Starter, le premier forfait qui permet de générer un jeton.

Commencer gratuitement Consulter l’espace développeur

60 requêtes par minute par jeton · chaque réponse 429 inclut un en-tête Retry-After · utilisez des jetons distincts pour l’intégration continue et la production

la console est un client API

Pousser, traduire, valider et récupérer, chacun étant un point de terminaison REST.

Chaque ligne de l’illustration ci-dessous correspond à une route : poussée, validations, glossaire, lots et récupération, toutes accessibles depuis votre propre code avec un jeton de projet. L’environnement de test de l’API dans la console exécute en direct les opérations en lecture seule sur votre projet, afin que vous voyiez d’abord une réponse réelle.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Vous téléversez 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 diffusion de vos traductions se fait aussi via un point de terminaison

c’est simplement du HTTP

Quatre éléments que les équipes construisent en premier.

chacun est un seul point de terminaison et un jeton de projet · aucun ne prend tout l’après-midi

porte de fusion · un seul fichier de flux de travail

Affichez la demande d’extraction en rouge lorsqu’une traduction échoue.

cron · toutes les nuits

Traduisez les notes de version pendant la nuit, 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, non par compte, avec un en-tête Retry-After sur chaque 429 indiquant le nombre de secondes à attendre.

formats de fichier

poussez et tirez le format que votre dépôt utilise déjà. Les pluriels et les espaces réservés sont conservés dans les deux sens. Nommez-le avec format= lors de chaque appel.

événements webhook

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

outils MCP

le même jeton de projet, remis à un environnement d’exécution d’agent plutôt qu’à curl. npx -y @transglot/mcp.

FAQ

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

Comment m’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’identifiant de projet dans le chemin ni de clé à l’échelle du compte qui pourrait fuiter. 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. L’offre gratuite couvre la console, ce qui suffit pour voir si le produit convient, mais elle ne permet pas de créer un jeton. La CLI, l’action GitHub, les webhooks, MCP et le forfait de livraison reposent tous sur ce même jeton, ils arrivent donc ensemble.

Comment télécharger des chaînes vers 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 qui ont réellement changé sont traduites, donc pousser un fichier inchangé ne coûte rien.

Comment récupérer mes traductions?

GET /v1/pull, dans n’importe lequel des 20 formats, quand vous le souhaitez. C’est le point de terminaison encapsulé par la CLI, et celui que l’interface de test de l’API exécute en direct. 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. Si vous la dépassez, vous recevez un code 429 avec un en-tête Retry-After indiquant le nombre de secondes à attendre, et aucun frais n’est appliqué ni aucune écriture partielle effectuée. Utilisez des jetons distincts pour l’intégration continue et la production afin qu’une compilation bruyante ne prive pas votre application de ressources.

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 paramètres régionaux dans la table de référence, plus un repli structurel pour les balises qui n’y figurent pas. Ajoutez un paramètre régional au projet et la prochaine poussée l’inclura.

Quels formats de fichiers puis-je envoyer et recevoir?

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 forme qu’à l’envoi.

Transglot propose-t-il des webhooks?

Oui. Il existe 12 événements de webhook, notamment 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.

Y a-t-il un serveur MCP pour les agents d’IA?

Oui. npx -y @transglot/mcp expose 17 outils via votre jeton de projet, permettant ainsi à 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 depuis curl.

Puis-je l’exécuter dans l’intégration continue?

Oui. L’action GitHub (transglot/transglot-action@v1) et l’interface en ligne de commande encapsulent tous deux ces points de terminaison. Lorsqu’une ligne est refusée, transglot push --wait se termine avec le code 4 et l’action fait échouer la tâche pour cette exécution. Pour bloquer une fusion, exécutez-la sur les demandes de tirage en définissant son entrée de validation sur none, ajoutez une étape qui échoue lorsqu’une clé manque dans un fichier extrait, et faites de la tâche une vérification requise 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 l’échec persiste, la ligne est refusée plutôt qu’écrite. Une ligne qui dépasse uniquement sa limite de longueur est écrite, non refusée. GET /v1/batches/:id?include=failures liste les lignes refusées et la raison.

L’API risque-t-elle de rompre mon intégration?

Non. /v1 ajoute uniquement des points de terminaison et des champs de réponse; un champ que vous analysez déjà ne change ni de structure 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 consigne chaque version.

fonctionne avec ce que vous utilisez déjà

41 connecteurs, déjà intégrés.

Toutes les 41 intégrations

quatre minutes, un terminal

Rédigez la première requête aujourd’hui.

Commencer gratuitement Voir le coût d’une clé

aucune carte requise pour commencer · un jeton est fourni dès l’offre Starter et supérieures · la console exécute les points de terminaison de lecture en direct