Traduction des segments

Authentification

L’authentification doit être fournie dans l’en-tête de la demande sous la formeAuthorization: Bearer <API key>.

Clés API pour la traduction fondée sur des segments

Une clé API valide peut être

  • La clé API d’un utilisateur. L’utilisateur doit disposer du droit d’accès translate au sein du groupe auquel appartient le moteur.

  • Une clé API de traduction qui a été attribuée au moteur.

Paramètres nécessaires pour présenter une demande

À l’exception des phrases à traduire, les renseignements suivants sont toujours requis pour présenter des demandes avec succès — et ne devraient jamais être codés en dur dans les implémentations clientes :

Paramètre

Utilisation

URL de base du service

Les demandes doivent être envoyées à cette URL de base + /api/v1 + le point de terminaison.

Cette URL est déterminée par la région dans laquelle le moteur est déployé.

Clé d’API

Doit être envoyé parmi les en-têtes de la demande sous la forme Authorization: Bearer <API key>

Identifiant du moteur

L’UUID du moteur à utiliser pour traduire les segments. Doit être envoyé dans la charge utile JSON sous forme de engine_id

Points d’accès

La plus récente version de l’API est la version 1.

POST /traductions

Charge utile JSON

Paramètre

Requis:

Type :

Utilisation

engine_id

oui

string

L’UUID du moteur à utiliser.

sentences

oui

string[]

Les phrases à traduire. Ils peuvent être :

  • Texte brut

  • Fragment XML

  • Fichier XLIFF 1.2 ou XLIFF 2.1 bien formé (il n’est pas nécessaire d’insérer ou d’envelopper les phrases dans quoi que ce soit, c’est-à-dire que vous pouvez envoyer tout ce qui se trouve à l’intérieur de la balise<source>)

format

no

string

Le format de toutes les phrases envoyées dans la même demande dans le tableau sentences.

Valeurs acceptées :

  • text-plain

  • xliff:1.2

  • xliff:2.1

  • GLOBALESE 4.1.2+ xml

GLOBALESE 4.1.2+ Si ce paramètre n’est pas fourni, globalese by memoQ fera sa meilleure estimation. Il est recommandé de toujours préciser le format lorsqu’il est connu et de ne jamais laisser globalese by memoQ le détecter automatiquement lorsque le format est connu.

Si les segments traduisibles sont présentés dans des formats différents, ils doivent être envoyés dans des demandes distinctes.

Limites

La taille maximale de la requête est de 100 kilo-octets.

Exemple de demande

{
 "engine_id" : "<identifiant du moteur>",
 "format" : "xliff :1.2",
 "sentences" : [
 "Première phrase.",
 "Phrase <g id=\"1\">deux</g>." ]
}

Exemple de réponse

Une réponse réussie comporte un code de réponse 201 et la structure de corps suivante :

{
 « sentences » : [
 « Traduction un. »,
 « Traduction <g id=\"1\">deux</g>. » ]
}

Autres codes de réponse :

  • 400 – Requête incorrecte

  • 401 — non autorisé

  • 413 charge utile trop volumineuse

  • 500 erreur de serveur interne

  • 502 – Passerelle défectueuse (erreur lors de la traduction)

Exemple curl

La demande suivante présente une demande cURL complète à l’adresse /translations:

curl --location --request POST '<URL du service>/api/v1/translations' \ 
--header 'Authorization : Porteur <clé API>' \
--header 'Content-Type : application/json' \
--data-raw '{
 "engine_id" : "<identifiant du moteur>",
 "format" : "xliff :1.2",
 "sentences" : [
 "Première phrase.",
 "Phrase <g id=\"1\">deux</g>." ]
}'