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
, eisTransliterationSupported
.
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-RequestId da resposta e identificador do cliente do cabeçalho X-ClientTraceId da 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-RequestId da resposta e identificador do cliente do cabeçalho X-ClientTraceId da 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?'}]"