Condividi tramite

Traduttore 3.0: Traslitterazione

  • Articolo

Converte il testo in una lingua da uno script in un altro script.

Richiesta URL

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.

Parametri della richiesta

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.

Testo della richiesta

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.

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.

Una risposta JSON di esempio è:

[
    {"text":"konnnichiha","script":"Latn"},
    {"text":"sayounara","script":"Latn"}
]

Intestazioni della risposta

Intestazioni Descrizione
X-RequestId Valore generato dal servizio per identificare la richiesta e usata per la risoluzione dei problemi.

Codici di stato della risposta

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.

Esempi

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