Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Convertire caratteri o lettere di una lingua di origine nei caratteri o nelle lettere corrispondenti di una lingua di destinazione.
Richiesta URL
POST richiesta:
POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}
VedereSupporto della rete virtuale per Traduttore per la configurazione e il supporto di endpoint privati e di rete selezionati.
Parametri della richiesta
I parametri della richiesta inviati a una stringa di query sono:
| Query parameter (Parametro di query) | Descrizione | Condizione |
|---|---|---|
| versione-api | Versione dell'API richiesta dal client. Il valore deve essere 3.0. |
Parametro obbligatorio |
| lingua | Specifica la lingua di origine del testo da convertire da uno script a un altro. | Parametro obbligatorio |
| fromScript | Specifica lo script usato dal testo di input. | Parametro obbligatorio |
| toScript | Specifica lo script di output. | Parametro obbligatorio |
- È possibile eseguire query sul servizio per individuare
transliterationle lingue supportate per l'ambito. - Vedere ancheSupporto del linguaggio per la traslitterazione.
Intestazioni delle richieste
| Intestazioni | Descrizione | Condizione |
|---|---|---|
| Intestazioni di autenticazione | Vederele opzioni disponibili per l'autenticazione | Intestazione richiesta obbligatoria |
| Tipo di Contenuto | Specifica il tipo di contenuto del payload. Valore possibile: application/json |
Intestazione richiesta obbligatoria |
| La lunghezza del contenuto | Lunghezza del corpo della richiesta. | Facoltativo |
| X-ClientTraceId | GUID generato dal client che identifica in modo univoco la richiesta. È possibile omettere questa intestazione facoltativa se si include l'ID di traccia nella stringa di query usando un parametro di query denominato ClientTraceId. |
Facoltativo |
Corpo della risposta
Una risposta corretta è una matrice JSON con un risultato per ogni elemento nella matrice di input. Un oggetto risultato include le proprietà seguenti:
text: stringa risultante dalla conversione della stringa di input nello script di output.script: una stringa che specifica lo script usato nell'output.
Intestazioni della risposta
| Intestazioni | Descrizione |
|---|---|
| X-RequestId | Valore generato dal servizio per identificare la richiesta. Può essere usato a scopo di risoluzione dei problemi. |
Esempio di richiesta
curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latin"
Corpo della richiesta di esempio
Il corpo della richiesta è una matrice JSON. Ogni elemento di matrice è un oggetto JSON con una proprietà di stringa denominata Text, che rappresenta la stringa da convertire.
[
{"text":"こんにちは"},
{"text":"さようなら"}
]
Si applicano le limitazioni seguenti:
- La matrice può avere un massimo di 10 elementi.
- Il valore di testo di un elemento di matrice non può superare 1.000 caratteri, inclusi gli spazi.
- L'intero testo incluso nella richiesta non può superare i 5.000 caratteri, inclusi gli spazi.
Risposta JSON di esempio:
[
{
"text": "Kon'nichiwa",
"script": "Latin"
},
{
"text": "sayonara",
"script": "Latin"
}
]
Nota
- Ogni esempio viene eseguito nell'oggetto
localhostspecificato con ildocker runcomando . - Mentre il contenitore è in esecuzione,
localhostpunta al contenitore stesso. - Non è necessario usare
localhost:5000. È possibile usare qualsiasi porta non già in uso nell'ambiente host.
Traslitterare con l'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':'さようなら'}]"