Partilhar via


Recipiente: Texto transliterado

Converter caracteres ou letras de um idioma de origem para os caracteres ou letras correspondentes de um idioma de destino.

URL do Pedido

POST Pedido:

 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 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 Condição
api-version Versão da API solicitada pelo cliente. O valor deve ser 3.0. Parâmetro necessário
idioma Especifica o idioma de origem do texto a ser convertido de um script para outro. Parâmetro necessário
fromScript Especifica o script usado pelo texto de entrada. Parâmetro necessário
toScript Especifica o script de saída. Parâmetro necessário

Cabeçalhos do pedido

Cabeçalhos Description Condição
Cabeçalhos de autenticação Consulte as opções disponíveis para autenticação Cabeçalho de solicitação obrigatório
Tipo de Conteúdo Especifica o tipo de conteúdo da carga útil. Valor possível: application/json Cabeçalho de solicitação obrigatório
Comprimento do conteúdo O comprimento do corpo do pedido. Opcional
X-ClientTraceId 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. Opcional

Corpo da resposta

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

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

  • script: Uma cadeia de caracteres especificando o script usado na saída.

Cabeçalhos de resposta

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

Pedido de amostra

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

Corpo da solicitação da amostra

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

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

Aplicam-se as seguintes limitações:

  • A matriz pode ter um máximo de 10 elementos.
  • O valor de texto de um elemento de matriz não pode exceder 1.000 caracteres, incluindo espaços.
  • O texto inteiro 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"
  }
]

Nota

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

Transliterar com a 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':'さようなら'}]"

Passos Seguintes