Tradutor 3.0: Detetar

Identifica o idioma de um texto.

URL do Pedido

Envie um pedido POST para:

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

Consulte Suporte de rede virtual para configuração e suporte de rede selecionada e ponto final privado e de rede selecionada.

Parâmetros de solicitação

Os parâmetros de solicitação passados na cadeia de caracteres de consulta são:

Parâmetro de consulta Description
api-version Parâmetro necessário.
Versão da API solicitada pelo cliente. O valor deve ser 3.0.

Os cabeçalhos de solicitação incluem:

Cabeçalhos Description
Cabeçalhos de autenticação Cabeçalho de solicitação obrigatório.
Consulte as opções disponíveis para autenticação.
Tipo de Conteúdo Cabeçalho de solicitação obrigatório.
Especifica o tipo de conteúdo da carga útil. Os valores possíveis são: application/json.
Comprimento do conteúdo Opcional.
O comprimento do corpo do pedido.
X-ClientTraceId Opcional.
Um GUID gerado pelo cliente para identificar exclusivamente a solicitação. Você pode omitir esse cabeçalho se incluir a ID de rastreamento na cadeia de caracteres de consulta usando um parâmetro de consulta chamado ClientTraceId.

Corpo do pedido

O corpo da solicitação é uma matriz JSON. Cada elemento de matriz é um objeto JSON com uma propriedade string 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 solicitação de amostra tem a seguinte aparência:

[
    { "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 na solicitação não pode exceder 50.000 caracteres, incluindo espaços.

Corpo da resposta

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

  • language: Código do idioma detetado.

  • score: Um valor flutuante que indica a confiança no resultado. A pontuação está entre zero e um e uma pontuação baixa indica uma baixa confiança.

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

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

  • alternatives: Uma série de outras línguas possíveis. Cada elemento da matriz é outro objeto com as seguintes propriedades: language, score, isTranslationSupported, e isTransliterationSupported.

Um exemplo de resposta JSON é:

[

    {

        "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 a solicitação e usado para fins de solução de problemas.

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 Êxito.
400 Um dos parâmetros de consulta está em falta ou não é válido. Corrija os parâmetros de solicitação 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. Esse código geralmente indica que todas as traduções gratuitas fornecidas com uma assinatura de avaliação são usadas.
429 O servidor rejeitou a solicitação porque o cliente excedeu os limites de solicitação.
500 Erro inesperado. Se o erro persistir, informe-o com: data e hora da falha, identificador de solicitação do cabeçalho X-RequestIdda resposta e identificador do cliente do cabeçalho X-ClientTraceIdda solicitação.
503 Servidor temporariamente indisponível. Repita o pedido. Se o erro persistir, informe-o com: data e hora da falha, identificador de solicitação do cabeçalho X-RequestIdda resposta e identificador do cliente do cabeçalho X-ClientTraceIdda solicitação.

Se ocorrer um erro, a solicitação retornará uma resposta de erro JSON. O código de erro é um número de 6 dígitos que combina o código de status HTTP de 3 dígitos seguido por 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 a seguir mostra como recuperar 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?'}]"