Translator 3.0: Észlelés

  • Cikk

Egy szöveg nyelvét azonosítja.

URL-cím kérése

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

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

Lásd Virtual NetworkA Translator szolgáltatás támogatása kiválasztott hálózati és privát végpontok konfigurációját és támogatását.

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 kell lennie 3.0.

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 az elérhető hitelesítési 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.
Tartalomhossz 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ű karakterlánc-tulajdonsága van Text. A rendszer nyelvfelismerést alkalmaz a Text tulajdonság értékére. A nyelvi automatikus észlelés jobban működik a hosszabb beviteli szöveggel. A mintakérés törzse így néz ki:

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

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

  • A tömb legfeljebb 100 elemet tartalmazhat.
  • A kérelemben szereplő teljes szöveg nem haladhatja meg az 50 000 karaktert, szóközökkel együtt.

Választörzs

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

  • language: Az észlelt nyelv kódja.

  • score: Az eredmény megbízhatóságát jelző lebegőpontos érték. A pontszám nulla és egy között van, és az alacsony pontszám alacsony megbízhatóságot jelez.

  • isTranslationSupported: Logikai érték, amely igaz, ha az észlelt nyelv a szövegfordítás egyik támogatott nyelve.

  • isTransliterationSupported: Logikai érték, amely igaz, ha az észlelt nyelv az átíráshoz támogatott nyelvek egyike.

  • alternatives: Más lehetséges nyelvek tömbje. A tömb minden eleme egy másik objektum, amely a következő tulajdonságokat tartalmazza: language, scoreés isTranslationSupportedisTransliterationSupported.

Példa JSON-válaszra:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

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ésparamétereket.
401 A kérelem hitelesítése nem sikerült. 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 ad vissza. A hibakód egy 6 jegyű szám, amely a 3 jegyű HTTP-állapotkódot kombinálja, majd egy háromjegyű számmal 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 kérhetők le a szövegfordításhoz támogatott nyelvek.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"