Contêiner: Transliterar texto

Artigo
09/02/2024

Converta caracteres ou letras de um idioma de origem nos caracteres ou letras correspondentes de um idioma de destino.

URL de solicitação

POST pedir:

 POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

Consulte Suporte de Rede Virtual para configuração e suporte de rede e ponto de extremidade privado selecionados do serviço Translator.

Parâmetros da solicitação

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

Parâmetro de consulta	Descrição	Condição
api-version	Versão da API solicitada pelo cliente. O valor precisa ser `3.0`.	Parâmetro obrigatório
linguagem	Especifica o idioma de origem do texto a ser convertido de um script para outro.	Parâmetro obrigatório
fromScript	Especifica o script usado pelo texto de entrada.	Parâmetro obrigatório
toScript	Especifica o script de saída.	Parâmetro obrigatório

Você pode consultar o serviço para obter transliteration os idiomas com suporte do escopo.
Consulte também Suporte de idioma para transliteração.

Cabeçalhos da solicitação

Cabeçalhos	Descrição	Condição
Cabeçalhos de autenticação	Veja as opções disponíveis para autenticação	Cabeçalho de solicitação necessário
Content-Type	Especifica o tipo de conteúdo da carga. Valor possível: `application/json`	Cabeçalho de solicitação necessário
Content-Length	O tamanho do corpo da solicitação.	Opcional
X-ClientTraceId	Um GUID gerado pelo cliente para identificar exclusivamente a solicitação. É possível omitir esse cabeçalho se incluir a ID de rastreamento na cadeia de caracteres de consulta usando um parâmetro de consulta nomeado `ClientTraceId`.	Opcional

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 de caracteres que resulta da conversão da cadeia de caracteres de entrada no script de saída.
script: uma cadeia de caracteres especificando o script usado na saída.

Cabeçalhos de resposta

Cabeçalhos	Descrição
X-RequestId	Valor gerado pelo serviço para identificar a solicitação. Ele pode ser usado para fins de solução de problemas.

Solicitação de exemplo

curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn"

Exemplo de corpo da solicitação

O corpo da solicitação é uma matriz JSON. Cada elemento da matriz é um objeto JSON com uma propriedade de cadeia de caracteres denominada Text, que representa a cadeia de caracteres a converter.

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

As seguintes limitações se aplicam:

A matriz pode ter no máximo 10 elementos.
O valor de texto de um elemento de matriz não pode exceder 1.000 caracteres, incluindo os espaços.
Todo o texto incluído na solicitação não pode exceder 5.000 caracteres, incluindo espaços.

Exemplo de resposta JSON:

[
  {
    "text": "Kon'nichiwa",
    "script": "Latn"
  },
  {
    "text": "sayonara",
    "script": "Latn"
  }
]

Observação

Cada exemplo é executado no localhost que você especificou com o docker run comando.
Enquanto o contêiner está em execução, localhost aponta para o próprio contêiner.
Você não precisa usar localhost:5000. Você pode usar qualquer porta que ainda não esteja em uso em seu ambiente host.

Transliterar com API REST


  curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"

Próximas etapas

Saiba mais sobre a transliteração de texto

Compartilhar via