Translator 3.0: Átírás
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ásd: Virtual Network Support for Translator service selected network and private endpoint configuration and support.
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. Megadja 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. A kimeneti szkriptet adja meg. Keresse meg a támogatott nyelveket a transliteration hatókör használatával, és keresse meg a bemeneti nyelv és a bemeneti szkriptek kiválasztott kombinációjához elérhető kimeneti szkripteket. |
A kérelemfejlécek a következők:
Fejlécek | Leírás |
---|---|
Hitelesítési fejlécek | A kérelem szükséges fejléce. Tekintse meg a hitelesítéshez elérhető lehetőségeket. |
Content-Type | A kérelem szükséges fejléce. Megadja a hasznos adat tartalomtípusát. A lehetséges értékek a következők: application/json |
Tartalomhossz | Választható. A kérelem törzsének hossza. |
X-ClientTraceId | Választható. Ü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 sztringben egy névvel ellátott lekérdezési paraméterrel adja meg ClientTraceId . |
Kérés törzse
A kérelem törzse egy JSON-tömb. Minden tömbelem egy JSON-objektum, amelynek neve Text
egy sztringtulajdonság, amely az átalakítandó sztringet jelöli.
[
{"Text":"こんにちは"},
{"Text":"さようなら"}
]
A következő korlátozások érvényesek:
- A tömb legfeljebb 10 elemet tartalmazhat.
- Egy tömbelem 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.
Egy példa JSON-válasz:
[
{"text":"konnnichiha","script":"Latn"},
{"text":"sayounara","script":"Latn"}
]
Válaszfejlécek
Fejlécek | Leírás |
---|---|
X-RequestId | A szolgáltatás által a kérés azonosítására és hibaelhárítási célokra használt érték. |
Válaszállapot-kódok
A következő lehetséges HTTP-állapotkódokat adja vissza egy kérés.
Állapotkód | Leírás |
---|---|
200 | Sikeres. |
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érelem paramétereit. |
401 | A kérés nem hitelesíthető. Ellenőrizze, hogy a hitelesítő adatok meg vannak-e adva és érvényesek-e. |
403 | A kérés 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 használják. |
429 | A kiszolgáló elutasította a kérést, mert az ügyfél túllépte a kérelmek korlátait. |
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, a válaszfejléc kérésazonosítója X-RequestId és a kérelemfejléc ügyfélazonosítója 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, a válaszfejléc kérésazonosítója X-RequestId és a kérelemfejléc ügyfélazonosítója 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 adatai 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.txt
fájlba. Ügyeljen arra, hogy a fájlt kódolással UTF-8
mentse.
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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: