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

  1. Toutes les demandes doivent être authentifiées.

  2. Les en-têtes Content-Type et Content-Length appropriés doivent toujours être définis lors de l’envoi de charges utiles dans les requêtes POST/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.

Service de traduction

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

  1. Cette fonctionnalité est uniquement offerte dans la version infonuagique de globalese by memoQ.

  2. 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é:

  1. Recueillir auprès de l’utilisateur les renseignements de base nécessaires pour effectuer des appels d’API.

  2. Faire en sorte que l’utilisateur sélectionne un moteur à utiliser.

  3. 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