Tradutor 3.0: Detetar
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
,score
isTranslationSupported
eisTransliterationSupported
.
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-RequestId de resposta e o identificador de cliente do cabeçalho X-ClientTraceId do 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-RequestId de resposta e o identificador de cliente do cabeçalho X-ClientTraceId do 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?'}]"