added
Le modèle de clé de déploiement, où le jeton bearer EST le projet. C’est ce que utilisent à la fois la CLI et l’action GitHub.
API v1 · actuelle
Le journal des modifications de l’API.
Aucune suppression.
/v1 ne fait qu’ajouter des fonctionnalités. Les nouveaux points de terminaison et les nouveaux champs de réponse sont intégrés sous le même préfixe, et un champ que vous analysez déjà ne change jamais de structure 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 utilisé
le seul préfixe utilisé
5 versions
11 modifications, aucune 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 servi par l’API.
5
versions sur /v1, toutes additives
1
préfixe de version utilisé. 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 flèches du clavier pour naviguer
2026-07-08
Distribution CDN, utilisation et bac à sable
July 8, 2026 · 4 modifications
05 / 05
added
/v1/incontext/translations, /screenshots et /suggest alimentent l’éditeur visuel, avec un 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 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
Ajout de /v1/glossary/import, /export et /extract, permettant d’importer et d’exporter une base terminologique sans ouvrir la console.
CRUD complet de la base terminologique 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 besoin de nouveaux sondages.
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 douze cas à ce jour ; fiez-vous au décompte de l’énumération plutôt qu’à cette ligne.
Les webhooks signés émettent des événements clés, traductions, langues, glossaire et QA aux côtés de la paire de lots 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 enregistrent 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 de submerger un point de terminaison lors d’une modification groupée.
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 votre CI avec POST /v1/cdn/publish, et autorisez les lectures avec une clé dédiée en lecture seule dans l’en-tête X-Transglot-Cdn-Key. Peut être placée derrière votre propre CDN.
La publication promeut les traductions actuelles vers une nouvelle version immuable, manuellement ou à chaque push.
added
Aucun corps de requête n’est stocké. Il s’agit uniquement d’un comptage.
Chaque appel authentifié à /v1 est comptabilisé par jeton et par jour, et affiché sur le hub de déploiement.
improved
Projet, pull, lots et export du glossaire. Aucune forme de requête ou de réponse n’a été modifiée pour permettre son fonctionnement.
Le hub de déploiement intègre un bac à sable API qui exécute en direct les points de terminaison en lecture seule sur votre projet.
registre des dépréciations
Rien ne va disparaître.
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é | Statut | Date de suppression |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | actuel | aucune prévue |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | actuel | aucune prévue |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | actuel | aucune prévue |
POST /v1/qa/run | June 12, 2026 | actuel | aucune prévue |
Signed webhook events, twelve typed cases | June 30, 2026 | actuel | aucune prévue |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | actuel | aucune prévue |
Une ligne n’est jamais supprimée de ce tableau. Si une surface est retirée, elle conserve sa ligne et obtient une date, car une suppression que vous pouvez anticiper est tout l’intérêt de publier ce registre.
la promesse de compatibilité
Trois règles sur laquelle vous pouvez construire.
additif
De nouveaux points de terminaison et de nouveaux champs de réponse sont déployés dans /v1. Un champ que vous analysez déjà ne change pas de structure et ne disparaît pas.
nouveau préfixe
Une modification incompatible serait déployée sous un nouveau préfixe de version plutôt que dans celui-ci. Ce préfixe est réservé et inutilisé, et chaque version ultérieure a été publiée sous v1.
en-têtes transparents
Lorsqu'une extraction ne peut pas effectuer un aller-retour complet, elle l'indique dans un en-tête. 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 la dépréciation des 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 jamais casser 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 une modification ne peut jamais être faite de manière additive, elle sera placée sous un nouveau préfixe, tandis que l'ancien continuera de fonctionner.
Quelque chose a-t-il été déprécié 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 déployée et une colonne de suppression indiquant actuellement « aucune prévue » tout au long.
Quel préavis serait donné pour une suppression ?
Une suppression apparaîtrait dans ce registre avec une date bien avant qu'elle n'ait lieu, et la ligne resterait dans le tableau par la suite au lieu de disparaître. Le fait de disposer d'une date contre laquelle planifier est tout l'intérêt de la publication.
Comment savoir quand quelque chose de nouveau est déployé ?
Chaque version est datée sur cette page. Le journal des modifications du produit couvre tout le reste qui est déployé, et la console affiche un marqueur 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 porte 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 bearer commence avec le forfait Starter à 19 $ par mois. L'offre gratuite couvre la console mais ne permet pas de générer un jeton, et la CLI, 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 n'est que le registre de ce qui a changé et quand.
Fonctionne avec vos outils actuels
41 connecteurs, déjà intégrés.
le contrat est le produit
Construire sur une API qui ne bouge pas.
L’API est disponible à partir du plan Starter. 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.