Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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}
Consultesuporte de rede virtual para tradução de rede selecionada e configuração de ponto de extremidade privado e suporte.
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 |
|---|---|---|
| versão da API | 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
transliterationos idiomas com suporte do escopo. - Consulte tambémSuporte de idioma para transliteração.
Cabeçalhos da solicitação
| Cabeçalhos | Descrição | Condição |
|---|---|---|
| Cabeçalhos de autenticação | Vejaas opções disponíveis para autenticação | Cabeçalho de solicitação necessário |
| Tipo de conteúdo | Especifica o tipo de conteúdo da carga. Valor possível: application/json |
Cabeçalho de solicitação necessário |
| Tamanho do conteúdo | O tamanho do corpo da solicitação. | Opcional |
| X-ClientTraceId | Um GUID gerado pelo cliente para identificar exclusivamente a solicitação. Você pode omitir esse cabeçalho opcional 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 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=Latin"
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": "Latin"
},
{
"text": "sayonara",
"script": "Latin"
}
]
Observação
- Cada exemplo é executado no
localhostque você especificou com odocker runcomando. - Enquanto o contêiner está em execução,
localhostaponta 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 de host.
Transliterar com API REST
curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latin" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"