Traduttore 3.0: Traslitterazione
Converte il testo in una lingua da uno script in un altro script.
Inviare una richiesta POST
a:
https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0
Vedere Rete virtuale Supporto per il servizio Translator selezionato per la configurazione e il supporto di endpoint privati e di rete.
I parametri della richiesta inviati a una stringa di query sono:
Query parameter (Parametro di query) | Descrizione |
---|---|
api-version | Parametro obbligatorio. Versione dell'API richiesta dal client. Il valore deve essere 3.0 . |
lingua | Parametro obbligatorio. Specifica la lingua del testo da convertire da uno script a un altro. Le lingue possibili sono elencate nell'ambito transliteration ottenuto a seguito di una query al servizio per le lingue supportate. |
fromScript | Parametro obbligatorio. Specifica lo script usato dal testo di input. Ricercare le lingue supportate usando l'ambito transliteration per trovare script di input disponibili per la lingua selezionata. |
toScript | Parametro obbligatorio. Specifica lo script di output. Ricercare le lingue supportate usando l'ambito transliteration per trovare script di output disponibili per la combinazione selezionata di lingua e di script di input. |
Le intestazioni della richiesta includono:
Intestazioni | Descrizione |
---|---|
Intestazioni di autenticazione | Intestazione della richiesta obbligatoria. Vedere le opzioni disponibili per l'autenticazione. |
Content-Type | Intestazione della richiesta obbligatoria. Specifica il tipo di contenuto del payload. I valori possibili sono: application/json |
Content-Length | Facoltativo. Lunghezza del corpo della richiesta. |
X-ClientTraceId | Facoltativo. GUID generato dal client che identifica in modo univoco la richiesta. È possibile omettere questa intestazione se nella stringa della query si include l'ID traccia usando un parametro di query denominato ClientTraceId . |
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 deve essere composta al massimo da 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.
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.
Una risposta JSON di esempio è:
[
{"text":"konnnichiha","script":"Latn"},
{"text":"sayounara","script":"Latn"}
]
Intestazioni | Descrizione |
---|---|
X-RequestId | Valore generato dal servizio per identificare la richiesta e usata per la risoluzione dei problemi. |
Di seguito sono riportati i possibili codici di stato HTTP restituiti da una richiesta.
Codice di stato | Descrizione |
---|---|
200 | Esito positivo. |
400 | Uno dei parametri di query manca o non è valido. Prima di riprovare, correggere i parametri della richiesta. |
401 | Impossibile autenticare la richiesta. Verificare che le credenziali siano state specificate e che siano valide. |
403 | La richiesta non è autorizzata. Controllare il messaggio di errore per i dettagli. Questo codice indica spesso che vengono usate tutte le traduzioni gratuite fornite con una sottoscrizione di valutazione. |
429 | Il server ha rifiutato la richiesta perché il client ha superato i limiti delle richieste. |
500 | Errore imprevisto. Se l'errore persiste, segnalarlo specificando data e ora dell'errore, identificatore della richiesta dall'intestazione della riposta X-RequestId e identificatore del client dall'intestazione della richiesta X-ClientTraceId . |
503 | Il server è temporaneamente non disponibile. ripetere la richiesta. Se l'errore persiste, segnalarlo specificando data e ora dell'errore, identificatore della richiesta dall'intestazione della riposta X-RequestId e identificatore del client dall'intestazione della richiesta X-ClientTraceId . |
Se si verifica un errore, la richiesta restituisce anche una risposta di errore JSON. Il codice errore è un numero a 6 cifre che combina il codice di stato HTTP a 3 cifre seguito da un numero a 3 cifre per classificare ulteriormente l'errore. I codici di errore più comuni sono reperibili nella pagina di riferimento Traduttore v3.
L'esempio seguente illustra come convertire due stringhe in lingua giapponese in giapponese romanizzato.
Il payload JSON per la richiesta in questo esempio:
[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]
Se si usa cURL in una finestra della riga di comando che non supporta i caratteri Unicode, prendere il payload JSON seguente e salvarlo in un file denominato request.txt
. Assicurarsi di salvare il file con la codifica UTF-8
.
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