Obtenir les formats de glossaire pris en charge

Article
06/01/2024

Fonctionnalité de référence
: Api traduction de documents
Azure AI Traducteur → version : méthode HTTP 2024-05-01
: GET

Cette méthode retourne une liste de formats de glossaire pris en charge par la fonctionnalité 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é 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	Description	Condition
Ocp-Apim-Subscription-Key	Votre clé API de service Traducteur à partir du Portail Azure.	Requis
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.
Content-Type	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	Description
200	OK. 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	Type	Description
value	FileFormat []	FileFormat[] contient les détails listés ci-dessous.
value.contentTypes	string []	Content-Types pris en charge pour ce format.
value.defaultVersion	string	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	string	Nom du format.
value.versions	string []	Version prise en charge.

Réponse d’erreur

Nom	Type	Description
code	string	Enums contenant des codes d’erreur généraux. Valeurs possibles : • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •Non autorisée
message	string	Obtient un message d’erreur général.
innerError	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	string	Obtient la chaîne d’erreur de code.
innerError.message	string	Obtient un message d’erreur général.
innerError.target	string	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 du service Traduction de document et de la bibliothèque de client.

Bien démarrer avec la traduction de documentation

Partager via