Translator 3.0 : Detect

Article
09/24/2023

Identifie la langue d’un texte.

URL de la demande

Envoyez une demande POST à :

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

Consultez la sectionPrise en charge des réseaux virtuels du service Translator sélectionné pour la configuration et la prise en charge du point de terminaison privé et du réseau.

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
api-version	Paramètre obligatoire. Version de l’API demandée par le client. La valeur doit être `3.0`.

Les en-têtes de demande sont les suivants :

headers	Description
En-tête(s) d’authentification	En-tête de demande obligatoire. Voir les options disponibles pour l’authentification.
Content-Type	En-tête de demande obligatoire. Spécifie le type de contenu de la charge utile. Les valeurs possibles sont les suivantes : `application/json`.
Content-Length	En-tête de demande obligatoire. Longueur du corps de la demande.
X-ClientTraceId	Facultatif. 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`.

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. La détection de la langue est appliquée à la valeur de la propriété Text. La détection automatique de la langue fonctionne mieux avec un texte d’entrée plus long. Voici un exemple de corps de la demande :

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Les limites suivantes s'appliquent :

Le tableau ne peut pas compter plus de 100 éléments.
L’intégralité du texte inclus dans la demande ne peut pas dépasser 50 000 caractères, espaces comprises.

Response body

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

language: code de la langue détectée.
score: valeur flottante indiquant le niveau de confiance dans le résultat. Le score est compris entre zéro et un, un score faible indiquant un niveau de confiance bas.
isTranslationSupported : valeur booléenne true si la langue détectée est l’une des langues prises en charge pour la traduction de texte.
isTransliterationSupported : valeur booléenne true si la langue détectée est l’une des langues prises en charge pour la translittération.
alternatives: tableau des autres langues possibles. Chaque élément du tableau est un autre objet dont les propriétés sont les suivantes : language, score, isTranslationSupported et isTransliterationSupported.

Exemple de réponse JSON :

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

En-têtes de réponse

headers	Description
X-RequestId	Valeur générée par le service pour identifier la demande. Elle sert à des fins de dépannage.

Codes d’état de réponse

Voici les codes d’état HTTP qu’une demande peut retourner.

Code d’état	Description
200	Réussite.
400	L’un des paramètres de requête est manquant ou non valide. Corrigez les paramètres de demande avant de réessayer.
401	Il n’a pas été possible d’authentifier la demande. Vérifiez que les informations d’identification sont spécifiées et valides.
403	La requête n’est pas autorisée. Vérifiez le message d’erreur détaillé. Ce code indique souvent que toutes les traductions gratuites fournies avec un abonnement d’essai ont été utilisées.
429	Le serveur a rejeté la requête, car le client a dépassé les limites de requête.
500	Une erreur inattendue s’est produite. Si l’erreur persiste, signalez-la en fournissant les informations suivantes : date et heure de la défaillance, identificateur de la demande dans l’en-tête de réponse,`X-RequestId` et identificateur du client dans l’en-tête de demande `X-ClientTraceId`.
503	Serveur temporairement indisponible. Relancez la requête. Si l’erreur persiste, signalez-la en fournissant les informations suivantes : date et heure de la défaillance, identificateur de la demande dans l’en-tête de réponse,`X-RequestId` et identificateur du client dans l’en-tête de demande `X-ClientTraceId`.

Si une erreur se produit, la requête renvoie une réponse d’erreur JSON. Le code d’erreur est un nombre à 6 chiffres qui combine le code d’état HTTP à 3 chiffres et un nombre à 3 chiffres qui sert à catégoriser plus précisément l’erreur. Vous trouverez les codes d’erreur les plus courants sur la page Référence de Translator v3.

Exemples

L’exemple suivant montre comment récupérer les langues prises en charge pour la traduction du texte.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"

Share via