Translator 3.0: Transliterate

Článek
09/01/2024

Převede text v jednom jazyce z jednoho skriptu na jiný skript.

Adresa URL požadavku

Odešlete požadavek POST do:

https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0

Viz Podpora virtuální sítě pro vybranou službu Translator a konfiguraci a podporu privátního koncového bodu.

Parametry požadavku

Parametry požadavku předané v řetězci dotazu jsou:

Parametr dotazu	Popis
verze-api	Povinný parametr. Verze rozhraní API požadovaného klientem Hodnota musí být `3.0`.
jazyk	Povinný parametr. Určuje jazyk textu, který se má převést z jednoho skriptu na jiný. Možné jazyky jsou uvedeny v `transliteration` oboru získaném dotazováním služby pro podporované jazyky.
fromScript	Povinný parametr. Určuje skript používaný vstupním textem. Vyhledejte podporované jazyky pomocí `transliteration` oboru a vyhledejte vstupní skripty dostupné pro vybraný jazyk.
toScript	Povinný parametr. Určuje výstupní skript. Vyhledejte podporované jazyky pomocí `transliteration` oboru a vyhledejte výstupní skripty dostupné pro vybranou kombinaci jazyka zadávání a vstupního skriptu.

Hlavičky požadavku zahrnují:

Hlavičky	Popis
Hlavičky ověřování	Požadovaná hlavička požadavku. Podívejte se na dostupné možnosti ověřování.
Typ obsahu	Požadovaná hlavička požadavku. Určuje typ obsahu datové části. Možné hodnoty: `application/json`
Délka obsahu	Volitelné. Délka textu požadavku.
X-ClientTraceId	Volitelné. Identifikátor GUID vygenerovaný klientem pro jedinečnou identifikaci požadavku. Tuto hlavičku můžete vynechat, pokud do řetězce dotazu zahrnete ID trasování pomocí parametru dotazu s názvem `ClientTraceId`.

Text požadavku

Text požadavku je pole JSON. Každý prvek pole je objekt JSON s řetězcovou vlastností s názvem Text, která představuje řetězec pro převod.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

Platí následující omezení:

Pole může mít maximálně 10 prvků.
Textová hodnota prvku pole nesmí překročit 1 000 znaků včetně mezer.
Celý text obsažený v požadavku nesmí překročit 5 000 znaků včetně mezer.

Text odpovědi

Úspěšná odpověď je pole JSON s jedním výsledkem pro každý prvek vstupního pole. Výsledný objekt obsahuje následující vlastnosti:

text: Řetězec, který je výsledkem převodu vstupního řetězce na výstupní skript.
script: Řetězec určující skript použitý ve výstupu.

Příkladem odpovědi JSON je:

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

Hlavičky odpovědi

Hlavičky	Popis
X-RequestId	Hodnota vygenerovaná službou k identifikaci požadavku a použití pro účely řešení potíží.

Stavové kódy odpovědí

Níže jsou uvedené možné stavové kódy HTTP, které požadavek vrátí.

Kód stavu	Popis
200	Akce byla úspěšná.
400	Jeden z parametrů dotazu chybí nebo je neplatný. Před opakováním opravte parametry požadavku.
401	Požadavek nelze ověřit. Zkontrolujte, jestli jsou zadané a platné přihlašovací údaje.
403	Požadavek není autorizovaný. Zkontrolujte chybovou zprávu s podrobnostmi. Tento kód často označuje, že se používají všechny bezplatné překlady poskytnuté se zkušebním předplatným.
429	Server odmítl požadavek, protože klient překročil limity požadavků.
500	Došlo k neočekávané chybě. Pokud chyba přetrvává, nahlašte ji s: datem a časem selhání, identifikátorem požadavku z hlavičky `X-RequestId`odpovědi a identifikátorem klienta z hlavičky `X-ClientTraceId`požadavku .
503	Server je dočasně nedostupný. Zkuste požadavek zopakovat. Pokud chyba přetrvává, nahlašte ji s: datem a časem selhání, identifikátorem požadavku z hlavičky `X-RequestId`odpovědi a identifikátorem klienta z hlavičky `X-ClientTraceId`požadavku .

Pokud dojde k chybě, požadavek vrátí také chybovou odpověď JSON. Kód chyby je 6místné číslo, které kombinuje 3místný stavový kód HTTP následovaný 3místným číslem, aby se chyba dále kategorizovala. Běžné kódy chyb najdete na referenční stránce služby Translator v3.

Příklady

Následující příklad ukazuje, jak převést dva japonské řetězce do romanizované japonštiny.

Datová část JSON pro požadavek v tomto příkladu:

[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]

Pokud používáte cURL v okně příkazového řádku, které nepodporuje znaky Unicode, použijte následující datovou část JSON a uložte ji do souboru s názvem request.txt. Nezapomeňte soubor uložit s kódováním 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

Sdílet prostřednictvím