Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 des formats de document pris en charge par la fonctionnalité de traduction de documents. La liste inclut les extensions de fichier courantes et le type de contenu si vous utilisez l’API de chargement.
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=document"
En-têtes de requête
Les en-têtes de requête sont les suivants :
| headers | Descriptif |
|---|---|
| Ocp-Apim -Subscription-Key | En-tête de requête 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 documents pris en charge. |
| 500 | Erreur interne du serveur. |
| Autres codes d’état | • Trop de demandes • Serveur temporaire indisponible |
Réponse du format de fichier
Réponse fileFormatListResult positive
Les informations suivantes sont retournées dans une réponse positive.
| Nom | Catégorie | Descriptif |
|---|---|---|
| valeur | FileFormat [] | FileFormat[] contient les détails listés ci-dessous. |
| value.contentTypes | chaîne de caractères[] | Content-Types pris en charge pour ce format. |
| value.defaultVersion | ficelle | Version par défaut si aucune n’est spécifiée. |
| value.fileExtensions | chaîne de caractères[] | 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 pour un document non valide. |
Exemples
Exemple de réponse positive
L’objet JSON suivant est un exemple de réponse positive.
Code d’état : 200
{
"value": [
{
"format": "PlainText",
"fileExtensions": [
".txt"
],
"contentTypes": [
"text/plain"
],
"versions": []
},
{
"format": "OpenXmlWord",
"fileExtensions": [
".docx"
],
"contentTypes": [
"application/vnd.openxmlformats-officedocument.wordprocessingml.document"
],
"versions": []
},
{
"format": "OpenXmlPresentation",
"fileExtensions": [
".pptx"
],
"contentTypes": [
"application/vnd.openxmlformats-officedocument.presentationml.presentation"
],
"versions": []
},
{
"format": "OpenXmlSpreadsheet",
"fileExtensions": [
".xlsx"
],
"contentTypes": [
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
],
"versions": []
},
{
"format": "OutlookMailMessage",
"fileExtensions": [
".msg"
],
"contentTypes": [
"application/vnd.ms-outlook"
],
"versions": []
},
{
"format": "HtmlFile",
"fileExtensions": [
".html",
".htm"
],
"contentTypes": [
"text/html"
],
"versions": []
},
{
"format": "PortableDocumentFormat",
"fileExtensions": [
".pdf"
],
"contentTypes": [
"application/pdf"
],
"versions": []
},
{
"format": "XLIFF",
"fileExtensions": [
".xlf"
],
"contentTypes": [
"application/xliff+xml"
],
"versions": [
"1.0",
"1.1",
"1.2"
]
},
{
"format": "TSV",
"fileExtensions": [
".tsv",
".tab"
],
"contentTypes": [
"text/tab-separated-values"
],
"versions": []
},
{
"format": "CSV",
"fileExtensions": [
".csv"
],
"contentTypes": [
"text/csv"
],
"versions": []
},
{
"format": "RichTextFormat",
"fileExtensions": [
".rtf"
],
"contentTypes": [
"application/rtf"
],
"versions": []
},
{
"format": "WordDocument",
"fileExtensions": [
".doc"
],
"contentTypes": [
"application/msword"
],
"versions": []
},
{
"format": "PowerpointPresentation",
"fileExtensions": [
".ppt"
],
"contentTypes": [
"application/vnd.ms-powerpoint"
],
"versions": []
},
{
"format": "ExcelSpreadsheet",
"fileExtensions": [
".xls"
],
"contentTypes": [
"application/vnd.ms-excel"
],
"versions": []
},
{
"format": "OpenDocumentText",
"fileExtensions": [
".odt"
],
"contentTypes": [
"application/vnd.oasis.opendocument.text"
],
"versions": []
},
{
"format": "OpenDocumentPresentation",
"fileExtensions": [
".odp"
],
"contentTypes": [
"application/vnd.oasis.opendocument.presentation"
],
"versions": []
},
{
"format": "OpenDocumentSpreadsheet",
"fileExtensions": [
".ods"
],
"contentTypes": [
"application/vnd.oasis.opendocument.spreadsheet"
],
"versions": []
},
{
"format": "Markdown",
"fileExtensions": [
".markdown",
".mdown",
".mkdn",
".md",
".mkd",
".mdwn",
".mdtxt",
".mdtext",
".rmd"
],
"contentTypes": [
"text/markdown",
"text/x-markdown",
"text/plain"
],
"versions": []
},
{
"format": "Mhtml",
"fileExtensions": [
".mhtml",
".mht"
],
"contentTypes": [
"message/rfc822",
"application/x-mimearchive",
"multipart/related"
],
"versions": []
}
]
}
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.