Un ensemble d ' appels API est disponible pour:
-
Intégration de Phrase et de tout logiciel tiers (Outils gestion de traduction, CMS, etc.)
-
Développement d'un établi de traducteur. L'éditeur TAO repose sur des API publiques.
-
Création d'un tout nouvel outil ou service utilisant Phrase dans son backend.
Flux de travaux de base
Les procédures et flux de travaux doivent être compris avant d'utiliser les API. Il est recommandé de se familiariser avec une procédure dans Phrase avant d'implémenter l'API associée.
Le flux de travaux fondamental est :
-
Créer une MT, BT et éventuellement, ajouter un moteur traduction automatique.
-
Créer un projet avec le moteur MT/BT/traduction automatique joint (si nécessaire).
-
Enregistre le projet comme modèle projet et réutilise-le pour créer un nouveau projet traduction.
-
Chargez votre fichier pour le traduire dans le projet (créez une tâche).
-
Vous pouvez ensuite analyser, prétraduire ou assigner la tâche à un linguiste
API asynchrones
Les API asynchrones doivent toujours être préférées à leurs homologues synchrones. Si vous appelez des API synchrones, il y a une chance de recevoir des réponses expirées après expiration lors du traitement de lots importants de fichiers, voire d'un seul fichier volumineux. Les API synchrones ne doivent être utilisées que pour les petits fichiers et l'intégration à petite échelle.
Sondage
Après avoir appelé une API asynchrone, une réponse instantanée est reçue, y compris la demande d'identifiant. Utilisez cet identifiant pour vérifier le statut de la demande en appelant getAsyncRequest et en cochant le champ asyncResponse . Cette approche de sondage peut conduire à un certain nombre d'appels getAsyncRequest avant de recevoir une réponse asynchrone qui n'est pas nulle.
Rappels
En réponse aux inconvénients de l'approche par sondage pour les demandes asynchrones, la prise en charge des rappels dans toutes les API asynchrones est prise en charge. Lorsqu ' une requête asynchrone est appelée, spécifier une adresse URL (dans le paramètre callbackUrl) qui est demandée une fois Terminé le travail commencé par la requête asynchrone.
Les rappels sont demandés via des appels HTTP POST et les données sont transmises dans le corps encodé en JSON. L'objet JSON contient toujours :
-
Informations relatives à la requête asynchrone (les mêmes que lors de l'appel à getAsyncRequest).
-
Des informations détaillées sur le résultat de l'action telles qu'une analyse complète ou des détails sur la tâche.
{
"asyncRequest": {
...
}
« analyser » : {
...
}
}
Si une adresse URL de rappel n'est pas accessible, la demande est répétée après 2, 4, 8, 16 et 30 minutes jusqu'à ce que 10 tentatives aient échoué.
L'adresse URL de rappel doit répondre avec le code statut HTTP 200 OK pour être considérée comme réussie.