Obtenir les formats de glossaire pris en charge

Fonctionnalité de référence
: Azure AI Translator → Version de l’API traduction de documents
: méthode HTTP 2024-05-01
: GET

Cette méthode retourne une liste de formats de glossaire pris en charge par la fonctionnalité de traduction de documents. La liste inclut les extensions de fichier courantes.

URL de la requête

Important

Toutes les demandes d’API adressées à la fonctionnalité de traduction de documents nécessitent un point de terminaison de domaine personnalisé situé sur la page vue d’ensemble de votre ressource dans le portail Azure.

curl -i -X GET "{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary"

En-têtes de requête

Les en-têtes de requête sont les suivants :

headers	Descriptif	Condition
Ocp-Apim-Subscription-Key	Votre clé API de service Translator à partir de l’Portail Azure.	Obligatoire
Ocp-Apim-Subscription-Region	Région dans laquelle votre ressource a été créée.	Obligatoire lors de l’utilisation d’une ressource régionale (géographique) comme USA Ouest. &puce.
Type de contenu	Type de contenu de la charge utile. Les valeurs acceptées sont application/json ou charset=UTF-8.	Obligatoire

Codes d’état de réponse

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

Code d’état	Descriptif
200	D’ACCORD. Retourne la liste des formats de fichiers de glossaires pris en charge.
500	Erreur interne du serveur.
Autres codes d’état	• Trop de demandes • Serveur temporaire indisponible

Réponse de get supported glossary formats

Type de base pour le retour de l’API get supported glossary formats.

Réponse positive de get supported glossary formats

Type de base pour le retour de l’API get supported glossary formats.

Nom	Catégorie	Descriptif
valeur	FileFormat []	FileFormat[] contient les détails listés ci-dessous.
value.contentTypes	string []	Content-Types pris en charge pour ce format.
value.defaultVersion	ficelle	Version par défaut si aucune n’est spécifiée.
value.fileExtensions	string []	Extension de fichier prise en charge pour ce format.
value.format	ficelle	Nom du format.
value.versions	string []	Version prise en charge.

Réponse d’erreur

Nom	Catégorie	Descriptif
code	ficelle	Enums contenant des codes d’erreur généraux. Valeurs acceptées : • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •Non autorisée
Message	ficelle	Obtient un message d’erreur général.
erreur interne	InnerTranslationError	Nouveau format d’erreur interne conforme aux instructions de l’API Azure AI services. Ce message d’erreur contient les propriétés requises ErrorCode, message et cible de propriétés facultatives, détails(paire clé valeur), erreur interne(il peut être imbriqué).
innerError.code	ficelle	Obtient la chaîne d’erreur de code.
innerError.message	ficelle	Obtient un message d’erreur général.
innerError.target	ficelle	Obtient la source de l’erreur. Par exemple, ce serait documents ou document id s’il y avait un document non valide.

Exemples

Exemple de réponse positive

L’objet JSON suivant est un exemple de réponse positive.

{
    "value": [
        {
            "format": "XLIFF",
            "fileExtensions": [
                ".xlf"
            ],
            "contentTypes": [
                "application/xliff+xml"
            ],
            "defaultVersion": "1.2",
            "versions": [
                "1.0",
                "1.1",
                "1.2"
            ]
        },
        {
            "format": "TSV",
            "fileExtensions": [
                ".tsv",
                ".tab"
            ],
            "contentTypes": [
                "text/tab-separated-values"
            ]
        },
        {
            "format": "CSV",
            "fileExtensions": [
                ".csv"
            ],
            "contentTypes": [
                "text/csv"
            ]
        }
    ]
}

Exemple de réponse d’erreur

L’objet JSON suivant est un exemple de réponse d’erreur. Le schéma des autres codes d’erreur est le même.

Code d’état : 500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

Étapes suivantes

Suivez notre guide de démarrage rapide pour en savoir plus sur l’utilisation de la traduction de documents et de la bibliothèque cliente.

Prise en main de la traduction de documents