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
translateau 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 |
|
Les demandes doivent être envoyées à cette URL de base + 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 |
|
Identifiant du moteur |
L’UUID du moteur à utiliser pour traduire les segments. Doit être envoyé dans la charge utile JSON sous forme de |
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 |
|
|
oui |
|
L’UUID du moteur à utiliser. |
|
|
oui |
|
Les phrases à traduire. Ils peuvent être : |
|
no |
|
Le format de toutes les phrases envoyées dans la même demande dans le tableau Valeurs acceptées :
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>." ] }'