Conteneur : Translittérer du texte

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}

ConsultezRé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.	Descriptif	Condition
version de l'API	Version de l’API demandée par le client. La valeur doit être 3.0.	Paramètre obligatoire
Langue	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 égalementla prise en charge de la langue pour la translittération.

En-têtes de requête

headers	Descriptif	Condition
En-têtes d’authentification	Voirles 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
Longueur du contenu	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 facultatif si vous incluez l’ID de trace dans la chaîne de requête à l’aide d’un paramètre de requête nommé ClientTraceId.	Facultatif

Corps de réponse

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	Descriptif
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