Intégrations
Permettre à d'autres apps auto-hébergées d'utiliser TraDoc comme moteur de traduction.
D'autres apps peuvent envoyer un document à TraDoc, suivre sa traduction et récupérer le fichier reconstruit, sans export ni import manuel. TraDoc le traduit avec sa chaîne habituelle, et le projet apparaît aussi dans TraDoc, avec le nom de l'app.
Connecter une app
- Ouvrez Paramètres → Intégrations.
- Nommez la connexion, par exemple
Ma bibliothèque, et choisissez son modèle par défaut. - Sélectionnez Créer la connexion et copiez la clé qui commence par
tdk_. Elle n'est affichée qu'une fois. - Dans l'autre app, saisissez l'adresse de l'API affichée sur la même page et la clé.
Déconnecter révoque la clé immédiatement ; les projets déjà créés restent dans TraDoc.
Ce qu'une app connectée peut faire
- vérifier la connexion et lister les modèles disponibles ;
- envoyer un fichier EPUB, PDF, DOCX, Markdown ou texte, dont la traduction démarre avec le modèle par défaut de la connexion sauf si l'app en choisit un autre ;
- suivre l'avancement, mettre en pause et reprendre ;
- télécharger le fichier traduit, ou un aperçu partiel avant la fin ;
- supprimer les projets qu'elle a créés.
Une connexion ne voit que ses propres projets. L'interface de TraDoc reste sans mot de passe ; seule l'API d'intégration exige la clé. Hors d'un réseau de confiance, placez TraDoc derrière HTTPS et un reverse proxy avec authentification.
Pour les développeurs
Points d'accès, champs, statuts et exemple curl complet : référence de l'API d'intégration (en anglais).