added
Le modèle de clé de déploiement, où le jeton porteur EST le projet. C’est ce sur quoi s’exécutent tant l’interface en ligne de commande que l’action GitHub.
api v1 · actuel
Le journal des modifications de l’API.
Rien n’est supprimé.
L’API /v1 ne fait qu’ajouter des fonctionnalités. De nouveaux points de terminaison et de nouveaux champs de réponse sont ajoutés sous le même préfixe, et un champ que vous analysez déjà ne change jamais de forme ni ne disparaît. Une modification incompatible serait publiée sous un nouveau préfixe de version, qui est réservé et encore vide.
v1/api/v1
le seul préfixe en usage
le seul préfixe en usage
5 versions
11 modifications, aucune d’elles n’est incompatible
la structure du journal
Un seul préfixe de version, aucune suppression.
Trois de ces quatre éléments sont des propriétés de ce journal lui-même. Le quatrième est la taille du catalogue de webhooks fourni par l’API.
5
versions sur /v1, toutes additives
1
préfixe de version en usage. Le suivant est réservé et vide
0
modifications incompatibles depuis le lancement de l’API
12
événements webhook signés. Source : App\Enums\WebhookEvent
daté par version, non par semver
utilisez les touches fléchées pour naviguer
2026-07-08
Livraison CDN, utilisation et aire de test
July 8, 2026 · 4 modifications
05 / 05
added
/v1/incontext/translations, /screenshots et /suggest alimentent l’éditeur visuel, avec un périmètre CORS limité à ce préfixe et rien d’autre.
POST /v1/incontext/session échange une clé publiable et une origine contre un jeton de session délimité.
improved
Une exportation bilingue signale désormais ce qu’elle n’a pas pu faire correspondre intégralement au lieu de substituer silencieusement le texte source. Les champs existants restent inchangés, ce qui est tout l’intérêt de les placer dans un en-tête.
GET /v1/pull a ajouté les en-têtes de réponse X-Skipped-Keys et X-Missing-Source-Keys.
added
Ainsi que /v1/glossary/import, /export et /extract, afin qu’une base de termes puisse être importée et exportée sans ouvrir la console.
Gestion CRUD complète de la base de termes via l’API : GET, POST, PUT et DELETE sur /v1/glossary.
added
Les résultats apparaissent dans les lignes de traduction que vous récupérez déjà, sans nécessiter de nouvelle interrogation.
POST /v1/qa/run déclenche un contrôle qualité agentique et renvoie l’identifiant de l’exécution.
added
Abonnez-vous par point de terminaison. La liste se trouve dans App\Enums\WebhookEvent, qui contient actuellement douze cas ; fiez-vous au décompte de l’énumération plutôt qu’à cette ligne.
Les webhooks signés émettent des événements liés aux clés, traductions, langues, glossaires et QA, en plus de la paire de lot d’origine.
improved
La livraison inclut un compteur et jusqu’à vingt échantillons, plutôt qu’un appel par ligne modifiée. Les journaux de livraison consignent chaque tentative avec l’heure de la prochaine nouvelle tentative.
Les événements à haute fréquence comme translation.updated sont regroupés en une seule livraison par fenêtre, évitant ainsi toute saturation du point de terminaison lors d’une modification en masse.
added
Il renvoie un ETag et un cache de courte durée, et respecte If-None-Match avec un code 304. Le sibling immuable sous /v{n} est adressé par contenu et mis en cache pendant un an.
Un GET public et cachable en bordure /v1/cdn/{project}/{locale} sert vos chaînes publiées.
added
Déclenchez-la dans le CI avec POST /v1/cdn/publish, et autorisez les lectures avec une clé en lecture seule dédiée dans l’en-tête X-Transglot-Cdn-Key. Sécuritaire à placer derrière votre propre CDN.
La publication promeut les traductions actuelles vers une nouvelle version immuable, manuellement ou à chaque envoi.
added
Aucun corps de requête n’est stocké. Il s’agit uniquement d’un comptage.
Chaque appel authentifié /v1 est comptabilisé par jeton par jour et affiché sur le hub de déploiement.
improved
Projet, extraction, lots et exportation du glossaire. Aucune forme de requête ou de réponse n’a été modifiée pour y parvenir.
Le hub de déploiement intègre désormais une aire de test API qui exécute en direct les points de terminaison en lecture seule pour votre projet.
registre des obsolescences
Rien ne disparaît.
Une ligne par surface publiée, avec la version qui l’a livrée. La dernière colonne est celle à surveiller : une suppression y apparaîtrait avec une date bien avant qu’elle ne survienne.
| Surface | Livré | État | Date de suppression |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | actuel | aucun prévu |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | actuel | aucun prévu |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | actuel | aucun prévu |
POST /v1/qa/run | June 12, 2026 | actuel | aucun prévu |
Signed webhook events, twelve typed cases | June 30, 2026 | actuel | aucun prévu |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | actuel | aucun prévu |
Une ligne n’est jamais supprimée de ce tableau. Si une surface est retirée, elle conserve sa ligne et se voit attribuer une date, car l’objectif même de publier une telle liste est de permettre une planification des suppressions.
l’engagement de compatibilité
Trois règles sur lesquelles vous pouvez bâtir.
additif
Les nouveaux points de terminaison et les nouveaux champs de réponse sont livrés dans /v1. Un champ que vous analysez déjà ne change pas de structure et ne disparaît pas.
nouveau préfixe
Un changement incompatible serait livré sous un nouveau préfixe de version plutôt qu’à l’intérieur de celui-ci. Ce préfixe est réservé et inutilisé, et chaque version ultérieure a été publiée sous v1.
en-têtes honnêtes
Lorsqu’une extraction ne peut pas effectuer un aller-retour complet avec certaines données, elle l’indique dans un en-tête. Les en-têtes X-Skipped-Keys et X-Missing-Source-Keys ont été ajoutés plutôt que de modifier le corps de la réponse à votre insu.
FAQ
Ce que les développeurs demandent sur le versionnement et l’obsolescence de l’API.
L’API Transglot est-elle versionnée?
Oui, par préfixe d’URL. Tout ce qui a été publié jusqu’à présent se trouve sous /v1, qui est le seul préfixe utilisé. Il n’y a pas d’en-tête de version, pas de fixation par date et rien à configurer.
Une mise à jour pourrait-elle un jour briser mon intégration?
Pas dans /v1. De nouveaux points de terminaison et de nouveaux champs de réponse sont ajoutés, mais un champ que vous analysez déjà ne change pas de structure et ne disparaît pas. Si un changement ne peut jamais être fait de manière additive, il passe sous un nouveau préfixe, et l’ancien continue de fonctionner.
Quelque chose a-t-il été rendu obsolète ou supprimé?
Rien, et le registre ci-dessus l’indique ligne par ligne. Chaque surface publiée est répertoriée avec la version qui l’a livrée et une colonne de suppression qui indique actuellement « aucune prévue » tout au long.
Quel serait le préavis en cas de suppression?
Une suppression apparaîtrait dans ce registre avec une date bien avant qu’elle ne se produise, et la ligne resterait dans le tableau par la suite plutôt que de disparaître. Une date contre laquelle vous pouvez planifier est tout l’intérêt d’en publier une.
Comment savoir quand quelque chose de nouveau est publié?
Chaque publication est datée sur cette page. Le journal des modifications du produit couvre tout le reste qui est publié, et la console affiche un indicateur lorsqu’il y a quelque chose que vous n’avez pas lu.
Pourquoi y a-t-il un journal des modifications distinct pour l’API?
Parce que l’API comporte une promesse de compatibilité qu’une version du produit n’a pas. Un développeur qui vérifie si une intégration fonctionne toujours ne devrait pas avoir à faire défiler le travail sur les fonctionnalités pour le savoir.
Comment ajouter l’API à mon forfait?
Un jeton porteur commence avec le forfait Starter à 19 $ par mois. L’offre gratuite couvre la console mais ne permet pas de créer un jeton, et l’interface de ligne de commande, l’action GitHub, les webhooks et MCP reposent tous sur ce même jeton.
Où se trouve la référence des points de terminaison eux-mêmes?
Sur la page API : authentification, points de terminaison, limite de débit, formats de fichiers et catalogue de webhooks. Cette page ne fait que consigner les modifications apportées et leur date.
fonctionne avec ce que vous utilisez déjà
41 connecteurs, déjà intégrés.
le contrat est le produit
Créer avec une API qui ne bouge pas.
L’API est disponible à partir du plan Starter et plus. Le plan gratuit est à 0 $ avec 100 000 mots pour commencer (25 000 à l’inscription, 75 000 après une vérification téléphonique), puis 10 000 par mois, sans accès à l’API ni aux webhooks.