Obtenha formatos de glossário suportados

Artigo
09/01/2024

Recurso de referência
: Azure AI Translator → Document Translation
API Versão: 2024-05-01
Método HTTP: GET

Este método devolve uma lista de formatos de glossário suportados pela funcionalidade Tradução de Documentos. A lista inclui as extensões de arquivo comuns.

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=glossary"

Cabeçalhos do pedido

Os cabeçalhos de solicitação são:

Cabeçalhos	Description	Condição
ocp-apim-subscription-key	Sua chave de API de serviço do Translator no portal do Azure.	Obrigatório
OCP-Apim-Assinatura-Região	A região onde o recurso foi criado.	Necessário ao usar um recurso regional (geográfico) como West US. e bala.
Tipo de conteúdo	O tipo de conteúdo da carga útil. O valor aceito é application/json ou charset=UTF-8.	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 glossário suportados.
500	Erro interno do servidor.
Outros códigos de status	• Demasiados pedidos • Servidor temporariamente indisponível

Obter resposta de formatos de glossário suportados

Tipo base para retorno de lista na API Obter formatos de glossário suportados.

Resposta de formatos de glossário suportada com sucesso

Tipo base para retorno de lista na API Obter formatos de glossário suportados.

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` se houvesse documento inválido.

Exemplos

Exemplo de resposta bem-sucedida

O objeto JSON a seguir é um exemplo de uma resposta bem-sucedida.

{
    "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"
            ]
        }
    ]
}

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.

Introdução à Tradução de Documentos

Partilhar via