Traduction fondée sur des segments au moyen de moteurs déployés
Toutes les API documentées aux présentes sont des API REST qui utilisent le format JSON (c’est-à-dire qu’elles l’acceptent et le renvoient).
Exigences générales
-
Toutes les demandes doivent être authentifiées.
-
Les en-têtes
Content-TypeetContent-Lengthappropriés doivent toujours être définis lors de l’envoi de charges utiles dans les requêtesPOST/PUT/PATCH.
Définitions
globalese by memoQ instance
Le système de l’utilisateur globalese by memoQ, accessible au moyen d’une URL telle que https://acme.globalese.ai ou d’une adresse similaire.
Le service qui accepte et traite les demandes de traduction fondées sur des segments. Ce service est indépendant de l’instance globalese by memoQ.
Moteur
Un modèle de traduction automatique capable de traduire d’une langue à une autre. Les projets de traduction faisant intervenir plusieurs langues sources ou langues cibles nécessiteront plusieurs moteurs.
Groupe
Plusieurs groupes peuvent être créés et utilisés dans globalese by memoQ. Un moteur appartient toujours à un groupe précis. Les utilisateurs peuvent être membres de plus d’un groupe et détenir des droits d’accès différents dans chacun d’eux.
Restrictions
-
Cette fonctionnalité est uniquement offerte dans la version infonuagique de globalese by memoQ.
-
Les moteurs de série ne peuvent pas être déployés.
Procédure proposée
Voici les grandes lignes de notre méthode privilégiée pour intégrer la fonctionnalité de traduction fondée sur des segments, accompagnées d’exemples.
Vous êtes libre de déterminer votre propre approche en fonction de la documentation de l’API, mais gardez à l’esprit que l’API privilégie la façon dont nous, chez globalese by memoQ, envisageons l’intégration.
Résumé:
-
Recueillir auprès de l’utilisateur les renseignements de base nécessaires pour effectuer des appels d’API.
-
Faire en sorte que l’utilisateur sélectionne un moteur à utiliser.
-
Utiliser le moteur sélectionné pour traduire un ou plusieurs segments.
1. Recueillir auprès de l’utilisateur les renseignements nécessaires
Les données obtenues aux présentes peuvent être conservées pendant une période plus longue, c’est-à-dire d’une session à l’autre, mais les utilisateurs doivent pouvoir les modifier ultérieurement.
L’utilisateur qui établit la connexion doit fournir :
-
L’URL de base de leur instance globalese by memoQ (p. ex.
https://acme.globalese.ai) -
Un moyen d’authentification. Ce qui peut être :
-
Une clé API globalese by memoQ de l’utilisateur (l’utilisateur doit détenir les droits d’accès requis).
-
Une clé API créée expressément pour utiliser certains moteurs aux fins de la traduction fondée sur des segments. Ces clés API ne sont associées à aucun utilisateur dans globalese by memoQ et sont généralement destinées à permettre à des utilisateurs externes (comme des traducteurs ou des postéditeurs) d’utiliser la fonctionnalité de traduction sans leur créer de compte utilisateur dans globalese by memoQ).
-
2. Interroger le moteur de requêtes à l’aide de l’API d’instance globalese by memoQ
Consultez la documentation de l’API ici : Interroger les renseignements sur le moteur et gérer les instances du moteur
Préalables :
-
URL de base, obtenu auprès de l’utilisateur
-
Authentification, obtenue de l’utilisateur
2.1. Lorsque l’utilisateur clique sur le bouton « Se connecter », obtenir une liste des moteurs, des instances de moteur, des langues et des groupes à partir de globalese by memoQ.
Si vous savez déjà quelle combinaison de langues est requise, ajoutez des filtres à l’appel GET /engines.
Moteurs
Les moteurs dont le tableau instance_ids n’est pas vide ont au moins une instance en cours de déploiement.
La valeur de uuid doit être utilisée lors d’un appel au service de traduction.
Instances de moteur
La valeur de engine_id est l’identifiant du moteur à partir duquel l’instance a été créée.
Si status est on, l’instance du moteur est prête à accepter des demandes de traduction.
La valeur de dispatcher_url est l’URL de base du service requise pour effectuer un appel au service de traduction.
Demandes :
GET <URL de l’instance Globalese>/api/v3/engines?sort=name :asc GET <URL de l’instance Globalese>/api/v3/engine-instances GET <URL de l’instance Globalese>/api/v3/languages?usage=engines :source GET <URL de l’instance Globalese>/api/v3/languages?usage=engines :target GET <URL de l’instance Globalese>/api/v3/groups?sort=name :asc
2.2. Présenter à l’utilisateur une liste de moteurs triée par ordre alphabétique. Les moteurs qui n’ont aucune instance dont l’état est on devraient tout de même figurer dans la liste pour fournir un meilleur contexte, mais devraient être inactifs (c’est-à-dire non sélectionnables).
2.3. Plus une organisation est grande, plus il est probable qu’elle dispose d’un plus grand nombre de moteurs. Il est donc recommandé d’offrir les options facultatives de filtrage suivantes :
-
Langues sources utilisées dans les moteurs
-
Langues cibles utilisées dans les moteurs
-
Groupes
Différences selon les types d’authentification
Si la clé API utilisée pour l’authentification appartient à un compte d’utilisateur globalese by memoQ, il est possible d’interroger les groupes. S’il s’agit d’une clé API destinée uniquement à la traduction, le point de terminaison GET /groups renverra une réponse 403. Dans ce cas, la liste déroulante « Groupes » devrait être inactive ou ne pas être affichée.
2.4 Si l’un ou l’autre de ces éléments est sélectionné, exécutez une nouvelle requête pour les moteurs en utilisant les paramètres de requête source_language, target_language ou group_ids.
Requête :
GET <URL de l’instance Globalese>/api/v3/engines?sort=name :asc&group_ids=1,2&source_language=en&target_language=de
3. Traduire les segments au moyen de l’API du service de traduction
Consultez la documentation de l’API ici : Traduction des segments
Préalables :
-
URL de base du service de traduction, obtenu à partir du point de terminaison
GET /engine-instances -
UUID du moteur, obtenu à partir du point de terminaison
GET /engines
Utilisez les paramètres configurés précédemment pour envoyer un ou plusieurs segments à traduire au service de traduction.
Requête :
POST <URL du service de traduction>/api/v1/translations

