Tradutor 3.0: Transliterar

  • Artigo

Converte texto num idioma de um script para outro.

URL do Pedido

Envie um pedido POST para:

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

VejaRede Virtual Suporte para suporte e configuração de ponto final privado 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.
language Parâmetro obrigatório.
Especifica o idioma do texto a converter de um script para outro. Os idiomas possíveis são listados no transliteration âmbito obtido ao consultar o serviço relativamente aos respetivos idiomas suportados.
fromScript Parâmetro obrigatório.
Especifica o script utilizado pelo texto de entrada. Procure idiomas suportados com o transliteration âmbito para encontrar scripts de entrada disponíveis para o idioma selecionado.
toScript Parâmetro obrigatório.
Especifica o script de saída. Procure idiomas suportados com o transliteration âmbito para encontrar scripts de saída disponíveis para a combinação selecionada de idioma de entrada e script de entrada.

Os cabeçalhos do pedido incluem:

Cabeçalhos Description
Cabeçalho(s) 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 chamado 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, que representa a cadeia a converter.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

Aplicam-se as seguintes limitações:

  • A matriz pode ter, no máximo, 10 elementos.
  • O valor de texto de um elemento de matriz não pode exceder 1000 carateres, incluindo espaços.
  • O texto inteiro incluído no pedido não pode exceder os 5000 carateres, incluindo espaços.

Corpo da resposta

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

  • text: uma cadeia que resulta da conversão da cadeia de entrada para o script de saída.

  • script: uma cadeia que especifica o script utilizado na saída.

Uma resposta JSON de exemplo é:

[
    {"text":"konnnichiha","script":"Latn"},
    {"text":"sayounara","script":"Latn"}
]

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 devolvidos por um pedido.

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 são 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, identificador do pedido do cabeçalho X-RequestIdde resposta e identificador do 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, identificador do pedido do cabeçalho X-RequestIdde resposta e identificador do cliente do cabeçalho X-ClientTraceIddo pedido .

Se ocorrer um erro, o pedido também 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 converter duas cadeias japonesas em japonês romanizado.

O payload JSON do pedido neste exemplo:

[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]

Se estiver a utilizar cURL numa janela de linha de comandos que não suporta carateres Unicode, utilize o seguinte payload JSON e guarde-o num ficheiro com o nome request.txt. Certifique-se de que guarda o ficheiro com UTF-8 a codificação.

curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d @request.txt