Contenitore: traslitterare il testo

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

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