Automatisez Transept avec l'API

Créez une clé API personnelle dans Paramètres → Développeur. Elle est disponible avec tous les forfaits, y compris le forfait Gratuit — il n'y a pas de barrière d'accès, c'est votre solde de mots qui limite l'utilisation. Donnez un nom à la clé, définissez éventuellement une date d'expiration et copiez le secret lorsqu'il s'affiche : il n'apparaît qu'une seule fois et ne pourra pas être récupéré par la suite. Révoquez une clé à tout moment depuis cette même page.

Les requêtes s'authentifient avec la clé dans un en-tête Authorization: Bearer tsk_live_… — uniquement dans l'en-tête, jamais dans l'URL.

Créez un document à partir de texte brut, HTML ou Markdown, ou téléchargez un fichier — les mêmes formats que ceux acceptés par l'application. Vous pouvez également importer une table de chaînes (.tstrings.json) : un format structuré pour le texte d'interface ou les chaînes de jeu, où chaque chaîne est une unité dotée d'une clé stable et de son propre contexte — une note sur sa nature, son emplacement, une limite de caractères et la signification de ses espaces réservés. Toutes ces informations sont transmises au modèle, les espaces réservés comme {name} sont protégés contre la suppression ou le renommage, et les pluriels sont développés selon la langue (une forme en anglais devient deux en allemand, quatre en ukrainien). Les traductions déjà présentes dans le fichier sont importées telles quelles, gratuitement, et alimentent immédiatement la mémoire de traduction.

Un lancement groupé permet de traduire dans plusieurs langues à la fois. Indiquez le nom du document, le Workflow ou le modèle à exécuter, ainsi que les langues cibles ; Transept crée les versions linguistiques manquantes et exécute le Workflow sur chacune d'elles. Un identifiant unique permet de suivre l'ensemble du processus — interrogez-le pour connaître l'avancement de chaque langue et savoir si une révision est en attente.

Pour les lancements répétés, soumettez de nouveau le fichier actuel d'une table de chaînes et Transept identifiera les changements : les chaînes inchangées conservent leurs traductions (ainsi que toute révision déjà effectuée), et le lancement ne traite que les nouvelles unités ou celles ayant réellement été modifiées — le pendant API de Ne lancer que ce qui a changé. Un appel de création de tâche accepte également un en-tête Idempotency-Key, de sorte qu'une nouvelle tentative après un incident réseau renvoie le résultat d'origine au lieu de générer un second document et une seconde facture.

Au lieu de procéder par interrogation périodique, enregistrez une URL et Transept vous enverra un événement push lorsqu'un lancement se termine ou échoue, lorsqu'une révision est prête à être examinée, lorsqu'un import a fini d'être traité ou qu'un export est prêt. Chaque envoi comporte un en-tête HMAC-SHA256 X-Transept-Signature: t=…,v1=… pour que votre système puisse vérifier qu'il provient bien de nous ; en cas d'échec d'un point de terminaison, de nouvelles tentatives sont effectuées avec un délai progressif (backoff) avant que celui-ci ne soit désactivé.

Un Workflow peut également s'exécuter automatiquement depuis une automatisation de base de données Notion : dirigez le webhook de l'automatisation vers l'URL de déclenchement et Transept lancera le Workflow sur la page modifiée. Le hic, c'est qu'un webhook Notion ne contient jamais le contenu de la page — il indique seulement quelle page a déclenché l'événement. Transept lit cette page via votre connexion Notion ; deux conditions doivent donc être réunies, sinon chaque déclenchement sera rejeté par une erreur d'accès et la carte de déclenchement affichera la mention « impossible de lire la page Notion » :

• Connectez Notion dans Transept — sous Paramètres → Intégrations. C'est le lien OAuth unique qui permet à Transept de lire en votre nom.
• Partagez la base de données source avec l'intégration dans Notion — ouvrez la base de données (ou la page), cliquez sur son menu •••, choisissez Connexions et ajoutez Transept. Connecter Notion dans les Paramètres n'accorde pas l'accès à une base de données spécifique en soi ; sans cette étape, la connexion est active mais la page reste illisible.
• Déclenchez l'exécution sur un changement de propriété, pas seulement sur une modification du corps. Les automatisations Notion se déclenchent lors de changements de propriétés (et d'ajouts de pages), donc modifier uniquement le corps d'une page peut ne rien déclencher. La méthode la plus fiable consiste à utiliser une propriété Statut surveillée par l'automatisation — modifiez-la (par ex. en « Prêt à traduire ») et c'est ce changement qui activera le déclencheur.

La liste complète des points de terminaison est publiée sous la forme d'une spécification OpenAPI que vous pouvez importer dans n8n, Zapier ou un générateur de code : consultez-la sur /public/v1/docs via votre API Transept, ou récupérez le JSON brut sur /public/v1/openapi.json. Les lancements effectués via l'API facturent les Wörter exactement comme dans l'éditeur de l'application.