API

Traduisez des données JSON et des fichiers, suivez leur progression et téléchargez les traductions terminées depuis votre serveur.

Utilisez l’API Lingo.dev pour traduire le contenu géré par votre application. Une tâche de localisation associe un moteur, une langue source, des langues cibles et un ou plusieurs documents. Chaque document suit une cible pour chacune des langues demandées. La plupart des formats produisent des fichiers cibles distincts ; les catalogues de chaînes Apple regroupent les langues dans un seul fichier.

L’URL de base de l’API est https://api.lingo.dev/v2. Conservez vos identifiants d’accès à l’API sur votre serveur. Commencez par votre première requête de traduction pour traduire deux messages et enregistrer le résultat.

Choisissez vos données d’entrée #

Votre contenuCommencez ici
Un objet JSON déjà présent dans votre applicationTraduire des données JSON. Envoyez l’objet directement dans la requête de création.
Des fichiers JSON, Markdown, HTML ou des ressources mobilesTraduire des documents. Téléversez les octets d’origine et téléchargez les fichiers dans le même format.
Plusieurs documents ou langues ciblesCréer une tâche de traduction. Une même tâche peut contenir à la fois des données JSON intégrées et des fichiers téléversés.

Ces trois options suivent le même cycle de vie :

  1. Créez une tâche et enregistrez son ID avec la révision de votre source.
  2. Téléversez chaque artefact répertorié dans le tableau uploads de la réponse. Les sources JSON intégrées sont stockées lors de la création.
  3. Démarrez la tâche.
  4. Suivez sa progression jusqu’à ce que toutes les cibles requises pour les documents soient terminées.
  5. Téléchargez chaque cible terminée depuis son status.downloadUrl.

La création enregistre le travail à effectuer ; le démarrage le prend en charge et lance le traitement. Une réponse de création réussie ne constitue pas un résultat traduit.

Estimez le travail avant de créer une tâche pour examiner les possibilités de réutilisation et le coût approximatif.

Configurez la traduction #

Sélectionnez explicitement un moteur avec engineId. Il fournit les modèles, les glossaires, les règles et la voix de marque, ainsi que le pipeline de traduction. La clé API doit autoriser la traduction avec ce moteur.

Pour les données JSON, ajoutez du contexte propre au document, des indications et des chemins protégés via format.options. Pour une révision ultérieure, fournissez la source précédente et ses traductions afin de réutiliser le contenu inchangé.

La relecture humaine permet aux personnes chargées de la relecture et disposant des autorisations nécessaires d’approuver ou de modifier les traductions admissibles avant la poursuite du pipeline. Le guide du workflow de relecture explique comment relier la soumission, la relecture et la livraison.

Conservez l’état de l’application avec la tâche #

Enregistrez durablement l’ID de la tâche, la révision de la source, les clés des documents et les langues demandées avant de poursuivre. Utilisez l’en-tête Idempotency-Key lors de la création d’une tâche pour pouvoir renouveler la requête en cas de réponse incertaine, sans créer de nouvelle tâche. Récupérez le travail existant avant de soumettre une tâche de remplacement.

Téléchargez les cibles terminées même si une autre cible échoue. Ne publiez un résultat que s’il correspond toujours à la révision de la source attendue par votre application. Créer un workflow de traduction explique comment assurer cette coordination.

Consultez les pages sur l’authentification et les erreurs, ainsi que le catalogue des erreurs, pour en savoir plus sur l’accès et la reprise après erreur.

Préparez et améliorez un moteur #

Le provisionnement alimente les glossaires, les règles et la voix de marque à partir du contenu d’un site web ou de texte. Les Suggestions du moteur transforment les retours en propositions que vous pouvez examiner et appliquer. Relisez les consignes générées avant de vous y fier pour la traduction.