Megosztás a következőn keresztül:

Translator 3.0: Szótári példák

  • Cikk

Példákat tartalmaz, amelyek bemutatják, hogyan használják a szótárban lévő kifejezéseket a kontextusban. Ezt a műveletet a szótárkereséssel együtt használjuk.

URL-cím kérése

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

https://api.cognitive.microsofttranslator.com/dictionary/examples?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.
from Kötelező paraméter.
A bemeneti szöveg nyelvét adja meg. A forrásnyelvnek a hatókör egyik támogatott nyelvének dictionary kell lennie.
felhasználóként a(z) Kötelező paraméter.
A kimeneti szöveg nyelvét adja meg. A célnyelvnek a hatókör egyik támogatott nyelvének dictionary kell lennie.

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ő hitelesítési> 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, amely a következő tulajdonságokkal rendelkezik:

Ilyen például a következő:

[
    {"Text":"fly", "Translation":"volar"}
]

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 a 100 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:

  • normalizedSource: A forráskifejezés normalizált formáját adó sztring. Ennek a tulajdonságnak általában meg kell egyeznie a Text kérelem törzsében található megfelelő listaindexben lévő mező értékével.

  • normalizedTarget: A célkifejezés normalizált formáját adó sztring. Ennek a tulajdonságnak általában meg kell egyeznie a Translation kérelem törzsében található megfelelő listaindexben lévő mező értékével.

  • examples: A (forráskifejezés, célkifejezés) pár példáinak listája. A lista minden eleme egy objektum, amely a következő tulajdonságokkal rendelkezik:

  • sourcePrefix: Az összefűzni kívánt sztring, amely a teljes példa értéke sourceTerm előtt összefűzendő. Ne adjon hozzá szóköz karaktert, mert már ott van, amikor lennie kell. Ez az érték lehet üres sztring.

  • sourceTerm: A tényleges kifejezéssel egyenlő sztring felnézett. A sztring hozzá lesz adva sourcePrefix a teljes példához, és sourceSuffix így létrejön a teljes példa. Az érték elválasztva van, így egy felhasználói felületen jelölhető meg, például félkövérrel.

    • sourceSuffix: Az összefűzendő sztring, amely a teljes példa értékét sourceTerm adja meg. Ne adjon hozzá szóköz karaktert, mert már ott van, amikor lennie kell. Ez az érték lehet üres sztring.

    • targetPrefix: A célhoz sourcePrefix hasonló sztring.

    • targetTerm: A célhoz sourceTerm hasonló sztring.

    • targetSuffix: A célhoz sourceSuffix hasonló sztring.

      Feljegyzés

      Ha nincs példa a szótárban, a válasz 200 (OK), de a examples lista egy üres lista.

Példák

Ez a példa bemutatja, hogyan kereshet példákat az angol kifejezésből fly és annak spanyol fordításából volarálló párra.

curl -X POST "https://api.cognitive.microsofttranslator.com/dictionary/examples?api-version=3.0&from=en&to=es" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'fly', 'Translation':'volar'}]"

A válasz törzse (az egyértelműség kedvéért rövidítve) a következő:

[
    {
        "normalizedSource":"fly",
        "normalizedTarget":"volar",
        "examples":[
            {
                "sourcePrefix":"They need machines to ",
                "sourceTerm":"fly",
                "sourceSuffix":".",
                "targetPrefix":"Necesitan máquinas para ",
                "targetTerm":"volar",
                "targetSuffix":"."
            },
            {
                "sourcePrefix":"That should really ",
                "sourceTerm":"fly",
                "sourceSuffix":".",
                "targetPrefix":"Eso realmente debe ",
                "targetTerm":"volar",
                "targetSuffix":"."
            },
            //
            // ...list abbreviated for documentation clarity
            //
        ]
    }
]