Obter formatos de documento suportados
Recurso de referência
: Azure AI Translator → Document Translation
API Versão: 2024-05-01
Método HTTP: GET
Esse método retorna uma lista de formatos de documento suportados pelo recurso de tradução de documentos. A lista inclui extensões de arquivo comuns e tipo de conteúdo se estiver usando a API de carregamento.
URL do Pedido
Importante
Todas as solicitações de API para o recurso Tradução de Documentos exigem um ponto de extremidade de domínio personalizado localizado na página de visão geral do recurso no portal do Azure.
curl -i -X GET "{document-translation-endpoint}/translator/document/formats?api-version={date}&type=document"
Cabeçalhos do pedido
Os cabeçalhos de solicitação são:
| Cabeçalhos | Description |
|---|---|
| Ocp-Apim-Subscription-Key | Cabeçalho de solicitação obrigatório |
Códigos de status de resposta
A seguir estão os possíveis códigos de status HTTP que uma solicitação retorna.
| Código de Estado | Description |
|---|---|
| 200 | OK. Retorna a lista de formatos de arquivo de documento suportados. |
| 500 | Erro interno do servidor. |
| Outros códigos de status | • Demasiados pedidos • Servidor temporariamente indisponível |
Resposta ao formato de ficheiro
Resposta bem-sucedida fileFormatListResult
As informações a seguir são retornadas em uma resposta bem-sucedida.
| Nome | Tipo | Description |
|---|---|---|
| valor | Formato de arquivo [] | FileFormat[] contém os detalhes listados. |
| value.contentTypes | string[] | Tipos de conteúdo suportados para este formato. |
| value.defaultVersion | string | Versão padrão se nenhuma for especificada. |
| value.fileExtensions | string[] | Extensão de arquivo suportada para este formato. |
| valor.format | string | Nome do formato. |
| valor.versões | string [] | Versão suportada. |
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| code | string | Enums contendo códigos de erro de alto nível. Valores possíveis: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiçoIndisponível • Não autorizado |
| mensagem | string | Obtém mensagem de erro de alto nível. |
| innerError | InnerTranslationError | Novo formato de Erro Interno que está em conformidade com as Diretrizes da API de serviços de IA do Azure. Esta mensagem de erro contém propriedades necessárias ErrorCode, mensagem e propriedades opcionais de destino, detalhes (par de valores de chave), erro interno (pode ser aninhado). |
| innerError.code | string | Obtém a cadeia de erro de código. |
| innerError.message | string | Obtém mensagem de erro de alto nível. |
| innerError.target | string | Obtém a origem do erro. Por exemplo, seria documents ou document id para um documento inválido. |
Exemplos
Exemplo de resposta bem-sucedida
O objeto JSON a seguir é um exemplo de uma resposta bem-sucedida.
Código de status: 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": []
}
]
}
Exemplo de resposta de erro
O objeto JSON a seguir é um exemplo de uma resposta de erro. O esquema para outros códigos de erro é o mesmo.
Código de status: 500
{
"error": {
"code": "InternalServerError",
"message": "Internal Server Error",
"innerError": {
"code": "InternalServerError",
"message": "Unexpected internal server error has occurred"
}
}
}
Próximos passos
Siga nosso guia de início rápido para saber mais sobre como usar a Tradução de Documentos e a biblioteca do cliente.