Contenitore: traslitterare il testo

Articolo
09/01/2024

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}

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	Condizione
api-version	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 transliteration le lingue supportate per l'ambito.
Vedere anche Supporto del linguaggio per la traslitterazione.

Intestazioni delle richieste

Intestazioni	Descrizione	Condizione
Intestazioni di autenticazione	Vedere le opzioni disponibili per l'autenticazione	Intestazione richiesta obbligatoria
Content-Type	Specifica il tipo di contenuto del payload. Valore possibile: `application/json`	Intestazione richiesta obbligatoria
Content-Length	Lunghezza del corpo della richiesta.	Facoltativo
X-ClientTraceId	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`.	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=Latn"

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": "Latn"
  },
  {
    "text": "sayonara",
    "script": "Latn"
  }
]

Nota

Ogni esempio viene eseguito nell'oggetto localhost specificato con il docker run comando .
Mentre il contenitore è in esecuzione, localhost punta 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=Latn" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"

Passaggi successivi

Altre informazioni sulla traslitterazione del testo

Condividi tramite