Tradutor 3.0: Detetar

  • Artigo

Identifica o idioma de um pedaço de texto.

URL do Pedido

Envie um pedido POST para:

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

ConsulteRede Virtual Suporte para o suporte e configuração de pontos finais privados e de rede selecionados do serviço Translator.

Parâmetros do pedido

Os parâmetros de pedido transmitidos na cadeia de consulta são:

Parâmetro de consulta Descrição
api-version Parâmetro obrigatório.
Versão da API pedida pelo cliente. O valor tem de ser 3.0.

Os cabeçalhos do pedido incluem:

Cabeçalhos Description
Cabeçalhos de autenticação Cabeçalho de pedido obrigatório.
Veja as opções disponíveis para autenticação.
Content-Type Cabeçalho de pedido obrigatório.
Especifica o tipo de conteúdo do payload. Os valores possíveis são: application/json.
Comprimento do Conteúdo Cabeçalho de pedido obrigatório.
O comprimento do corpo do pedido.
X-ClientTraceId Opcional.
Um GUID gerado pelo cliente para identificar exclusivamente o pedido. Pode omitir este cabeçalho se incluir o ID de rastreio na cadeia de consulta com um parâmetro de consulta com o nome ClientTraceId.

Corpo do pedido

O corpo do pedido é uma matriz JSON. Cada elemento de matriz é um objeto JSON com uma propriedade de cadeia chamada Text. A deteção de idioma é aplicada ao valor da Text propriedade. A deteção automática de idioma funciona melhor com texto de entrada mais longo. Um corpo de pedido de exemplo tem o seguinte aspeto:

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Aplicam-se as seguintes limitações:

  • A matriz pode ter, no máximo, 100 elementos.
  • O texto inteiro incluído no pedido não pode exceder 50 000 carateres, incluindo espaços.

Corpo da resposta

Uma resposta bem-sucedida é uma matriz JSON com um resultado para cada cadeia na matriz de entrada. Um objeto de resultado inclui as seguintes propriedades:

  • language: código do idioma detetado.

  • score: um valor flutuante que indica a confiança no resultado. A classificação é entre zero e um e uma classificação baixa indica uma confiança baixa.

  • isTranslationSupported: um valor booleano que é verdadeiro se o idioma detetado for um dos idiomas suportados para tradução de texto.

  • isTransliterationSupported: um valor booleano verdadeiro se o idioma detetado for um dos idiomas suportados para transliteração.

  • alternatives: uma matriz de outros idiomas possíveis. Cada elemento da matriz é outro objeto das seguintes propriedades: language, scoreisTranslationSupported e isTransliterationSupported.

Uma resposta JSON de exemplo é:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Cabeçalhos de resposta

Cabeçalhos Description
X-RequestId Valor gerado pelo serviço para identificar o pedido. É utilizado para fins de resolução de problemas.

Códigos de estado de resposta

Seguem-se os possíveis códigos de estado HTTP que um pedido devolve.

Código de Estado Description
200 Com êxito.
400 Um dos parâmetros de consulta está em falta ou não é válido. Corrija os parâmetros do pedido antes de tentar novamente.
401 Não foi possível autenticar o pedido. Verifique se as credenciais são especificadas e válidas.
403 O pedido não está autorizado. Verifique a mensagem de erro de detalhes. Este código indica frequentemente que todas as traduções gratuitas fornecidas com uma subscrição de avaliação foram utilizadas.
429 O servidor rejeitou o pedido porque o cliente excedeu os limites de pedidos.
500 Ocorreu um erro inesperado. Se o erro persistir, comunique-o com: data e hora da falha, o identificador de pedido do cabeçalho X-RequestIdde resposta e o identificador de cliente do cabeçalho X-ClientTraceIddo pedido .
503 Servidor temporariamente indisponível. Repita o pedido. Se o erro persistir, comunique-o com: data e hora da falha, o identificador de pedido do cabeçalho X-RequestIdde resposta e o identificador de cliente do cabeçalho X-ClientTraceIddo pedido .

Se ocorrer um erro, o pedido devolve uma resposta de erro JSON. O código de erro é um número de 6 dígitos que combina o código de estado HTTP de 3 dígitos seguido de um número de 3 dígitos para categorizar ainda mais o erro. Os códigos de erro comuns podem ser encontrados na página de referência do Tradutor V3.

Exemplos

O exemplo seguinte mostra como obter idiomas suportados para tradução de texto.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"