Sdílet prostřednictvím


Translator 3.0: Detekce

Identifikuje jazyk části textu.

Adresa URL požadavku

Odešlete požadavek POST do:

https://api.cognitive.microsofttranslator.com/detect?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.

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 jsou: 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. Rozpoznávání jazyka se použije na hodnotu Text vlastnosti. Automatické rozpoznávání jazyka funguje lépe s delším vstupním textem. Ukázkový text požadavku vypadá takto:

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

Platí následující omezení:

  • Pole může mít maximálně 100 prvků.
  • Celý text obsažený v požadavku nesmí překročit 50 000 znaků včetně mezer.

Text odpovědi

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

  • language: Kód zjištěného jazyka.

  • score: Hodnota float označující spolehlivost ve výsledku. Skóre je mezi nulou a jedním a nízkým skóre označuje nízkou spolehlivost.

  • isTranslationSupported: Logická hodnota, která je true, pokud zjištěný jazyk je jedním z jazyků podporovaných pro překlad textu.

  • isTransliterationSupported: Logická hodnota, která je true, pokud zjištěný jazyk je jedním z jazyků podporovaných pro transkliteraci.

  • alternatives: Pole dalších možných jazyků. Každý prvek pole je dalším objektem následující vlastnosti: language, score, isTranslationSupported, a isTransliterationSupported.

Příkladem odpovědi JSON je:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

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-RequestIdodpovědi a identifikátorem klienta z hlavičky X-ClientTraceIdpož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-RequestIdodpovědi a identifikátorem klienta z hlavičky X-ClientTraceIdpožadavku .

Pokud dojde k chybě, požadavek vrátí 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 načíst jazyky podporované pro překlad textu.

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?'}]"