Conteneur : Translittérer du texte

Article
09/01/2024

Convertissez des caractères ou des lettres d’une langue source en caractères ou lettres correspondants d’une langue cible.

URL de la requête

POST demander:

 POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

Consultez Réseau virtuel prise en charge du service Translator sélectionné pour la configuration et la prise en charge du réseau et du point de terminaison privé sélectionnés.

Paramètres de la demande

Les paramètres de demande transmis à la chaîne de requête sont les suivants :

Paramètre de requête.	Description	Condition
api-version	Version de l’API demandée par le client. La valeur doit être `3.0`.	Paramètre obligatoire
language	Spécifie la langue source du texte à convertir d’un script en un autre.	Paramètre obligatoire
fromScript	Spécifie le script utilisé par le texte d’entrée.	Paramètre obligatoire
toScript	Spécifie le script de sortie.	Paramètre obligatoire

Vous pouvez interroger le service pour obtenir transliteration des langues prises en charge par l’étendue.
Consultez également la prise en charge de la langue pour la translittération.

En-têtes de requête

headers	Description	Condition
En-têtes d’authentification	Voir les options disponibles pour l’authentification	En-tête de requête obligatoire
Type de contenu	Spécifie le type de contenu de la charge utile. Valeur possible : `application/json`	En-tête de requête obligatoire
Content-Length	Longueur du corps de la demande.	Facultatif
X-ClientTraceId	GUID généré par le client pour identifier de façon unique la demande. Vous pouvez omettre cet en-tête si vous incluez l’ID de trace dans la chaîne de requête à l’aide d’un paramètre de requête appelé `ClientTraceId`.	Facultatif

Response body

Une réponse correcte est un tableau JSON avec un résultat pour chaque élément dans le tableau d’entrée. Un objet de résultat inclut les propriétés suivantes :

text : une chaîne qui est le résultat de la conversion de la chaîne d’entrée en script de sortie.
script: chaîne spécifiant le script utilisé dans la sortie.

En-têtes de réponse

headers	Description
X-RequestId	Valeur générée par le service pour identifier la demande. Elle peut être utilisée à des fins de résolution des problèmes.

Exemple de requête

curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn"

Exemple de corps de la demande

Le corps de la demande est un tableau JSON. Chaque élément du tableau est un objet JSON avec une propriété de chaîne nommée Text, qui représente la chaîne à convertir.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

Les limites suivantes s'appliquent :

Le tableau peut avoir un maximum de 10 éléments.
La valeur texte d’un élément de tableau ne peut pas dépasser 1 000 caractères, espaces compris.
L’intégralité du texte inclus dans la demande ne peut pas dépasser 5 000 caractères, espaces comprises.

Exemple de réponse JSON :

[
  {
    "text": "Kon'nichiwa",
    "script": "Latn"
  },
  {
    "text": "sayonara",
    "script": "Latn"
  }
]

Remarque

Chaque exemple s’exécute sur le localhost fichier que vous avez spécifié avec la docker run commande.
Pendant que votre conteneur est en cours d’exécution, localhost pointe vers le conteneur lui-même.
Vous n’avez pas besoin d’utiliser localhost:5000. Vous pouvez utiliser n’importe quel port qui n’est pas déjà utilisé dans votre environnement hôte.

Translittération avec l’API REST


  curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"

Étapes suivantes

En savoir plus sur la translittération de texte

Partager via