Translator 3.0: Detect

Určuje jazyk části textu.

Adresa URL požadavku

Odešlete požadavek POST do:

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

VizVirtual Network Podpora pro konfiguraci a podporu vybrané sítě a privátního koncového bodu služby Translator.

Parametry požadavku

Parametry požadavku předávané řetězci dotazu jsou:

Parametr dotazu	Popis
verze-api	Povinný parametr. Verze rozhraní API vyžádaná klientem Hodnota musí být 3.0.

Mezi hlavičky požadavků patří:

Hlavičky	Description
Hlavičky ověřování	Požadovaná hlavička požadavku. Projděte si 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	Požadovaná hlavička požadavku. 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ý element pole je objekt JSON s vlastností řetězce 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. Tělo ukázkové žádosti 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 zahrnutý v požadavku nesmí být delší než 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. Objekt výsledku obsahuje následující vlastnosti:

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

• score: Plovoucí hodnota označující spolehlivost výsledku. Skóre je mezi nulou a 1 a nízké skóre značí nízkou spolehlivost.

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

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

• alternatives: Pole dalších možných jazyků. Každý prvek pole je jiný objekt s následujícími vlastnostmi: language, scoreisTranslationSupported a isTransliterationSupported.

Příklad odpovědi JSON:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Hlavičky odpovědi

Hlavičky	Description
X-RequestId	Hodnota vygenerovaná službou k identifikaci požadavku. Používá se 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í.

Stavový kód	Description
200	Úspěch.
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	Žádost není autorizovaná. Zkontrolujte chybovou zprávu s podrobnostmi. Tento kód často označuje, že všechny bezplatné překlady poskytované se zkušebním předplatným byly využity.
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á, nahlaste 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á, nahlaste 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 pro další kategorizaci chyby. 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?'}]"