Translator 3.0: Átírás

  • Cikk

Az egyik nyelven lévő szöveget egy szkriptből egy másik szkriptbe konvertálja.

URL-cím kérése

POST kérés küldése ide:

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

LásdVirtual Network A Translator szolgáltatás által kiválasztott hálózati és privát végpontok konfigurációja és támogatása című témakört.

Kérelemparaméterek

A lekérdezési sztringen átadott kérelemparaméterek a következők:

Lekérdezési paraméter Leírás
api-verzió Kötelező paraméter.
Az ügyfél által kért API verziója. Az értéknek meg kell lennie 3.0.
language Kötelező paraméter.
Meghatározza a szöveg nyelvét, amely az egyik szkriptből a másikba konvertálható. A lehetséges nyelvek a transliteration szolgáltatás támogatott nyelveinek lekérdezésével beszerzett hatókörben jelennek meg.
fromScript Kötelező paraméter.
A bemeneti szöveg által használt szkriptet adja meg. Keresse meg a támogatott nyelveket a transliteration hatókör használatával, és keresse meg a kiválasztott nyelvhez elérhető bemeneti szkripteket.
toScript Kötelező paraméter.
Megadja a kimeneti szkriptet. Keresse meg a támogatott nyelveket a transliteration hatókör használatával, és keresse meg a bemeneti és bemeneti szkriptek kiválasztott kombinációjához elérhető kimeneti szkripteket.

A kérelemfejlécek a következők:

Fejlécek Description
Hitelesítési fejléc(ek) Szükséges kérelemfejléc.
Tekintse meg a hitelesítéshez rendelkezésre álló lehetőségeket.
Content-Type Szükséges kérelemfejléc.
Megadja a hasznos adat tartalomtípusát. A lehetséges értékek a következők: application/json
Tartalom hossza Szükséges kérelemfejléc.
A kérelem törzsének hossza.
X-ClientTraceId Nem kötelező.
Ügyfél által létrehozott GUID a kérés egyedi azonosításához. Ezt a fejlécet kihagyhatja, ha a nyomkövetési azonosítót a lekérdezési sztringbe egy nevű ClientTraceIdlekérdezési paraméterrel adja meg.

A kérés törzse

A kérelem törzse egy JSON-tömb. Minden tömbelem egy JSON-objektum, amelynek egy nevű Textkarakterlánc-tulajdonsága van, amely az átalakítandó sztringet jelöli.

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

Az alábbi korlátozások érvényesek:

  • A tömb legfeljebb 10 elemet tartalmazhat.
  • A tömbelemek szöveges értéke nem haladhatja meg az 1000 karaktert, szóközökkel együtt.
  • A kérelemben szereplő teljes szöveg nem haladhatja meg az 5000 karaktert, szóközökkel együtt.

Választörzs

A sikeres válasz egy JSON-tömb, amely a bemeneti tömb minden eleméhez egy eredményt ad. Az eredményobjektumok a következő tulajdonságokat tartalmazzák:

  • text: Egy sztring, amely a bemeneti sztring kimeneti szkriptté való konvertálásából ered.

  • script: A kimenetben használt szkriptet meghatározó sztring.

Példa JSON-válaszra:

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

Válaszfejlécek

Fejlécek Description
X-RequestId A szolgáltatás által a kérés azonosítására létrehozott érték. Hibaelhárítási célokra használják.

Válaszállapot-kódok

A következő lehetséges HTTP-állapotkódok jelennek meg, amelyeket a kérés visszaad.

Állapotkód Description
200 Sikeres művelet.
400 A lekérdezési paraméterek egyike hiányzik vagy érvénytelen. Az újrapróbálkozás előtt javítsa ki a kérés paramétereit.
401 A kérést nem sikerült hitelesíteni. Ellenőrizze, hogy a hitelesítő adatok meg vannak-e adva és érvényesek-e.
403 A kérelem nincs engedélyezve. Ellenőrizze a részleteket tartalmazó hibaüzenetet. Ez a kód gyakran azt jelzi, hogy a próbaverziós előfizetéshez biztosított összes ingyenes fordítást felhasználták.
429 A kiszolgáló elutasította a kérést, mert az ügyfél túllépte a kérelemkorlátokat.
500 Váratlan hiba történt. Ha a hiba továbbra is fennáll, jelentse a következővel: a hiba dátuma és időpontja, kérésazonosító a válaszfejlécből X-RequestId, és ügyfélazonosító a kérelemfejlécből X-ClientTraceId.
503 A kiszolgáló átmenetileg nem érhető el. Ismételje meg a kérést. Ha a hiba továbbra is fennáll, jelentse a következővel: a hiba dátuma és időpontja, kérésazonosító a válaszfejlécből X-RequestId, és ügyfélazonosító a kérelemfejlécből X-ClientTraceId.

Hiba esetén a kérés JSON-hibaválaszt is ad vissza. A hibakód egy 6 jegyű szám, amely egyesíti a 3 jegyű HTTP-állapotkódot, majd egy háromjegyű számot a hiba további kategorizálásához. A gyakori hibakódokért tekintse meg a 3-as verziójú Translator referenciaoldalát.

Példák

Az alábbi példa bemutatja, hogyan konvertálhat két japán sztringet romanizált japánra.

A kérelem JSON-hasznos adata ebben a példában:

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

Ha olyan parancssori ablakban használja a cURL-t, amely nem támogatja a Unicode-karaktereket, használja az alábbi JSON-hasznos adatokat, és mentse azt egy nevű request.txtfájlba. Mindenképpen mentse a fájlt kódolással 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