Translator 3.0: Wykrywanie

Identyfikuje język fragmentu tekstu.

Adres URL żądania

Wyślij żądanie POST do:

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

ZobaczVirtual Network Obsługa wybranej sieci i prywatnej konfiguracji punktu końcowego w usłudze Translator oraz obsługi.

Parametry żądania

Parametry żądania przekazane w ciągu zapytania to:

Parametr zapytania	Opis
api-version	Wymagany parametr. Wersja interfejsu API żądanego przez klienta. Wartość musi mieć wartość 3.0.

Nagłówki żądań obejmują:

Nagłówki	Opis
Nagłówki uwierzytelniania	Wymagany nagłówek żądania. Zobacz dostępne opcje uwierzytelniania.
Content-Type	Wymagany nagłówek żądania. Określa typ zawartości ładunku. Możliwe wartości to: application/json.
Długość zawartości	Wymagany nagłówek żądania. Długość treści żądania.
X-ClientTraceId	Opcjonalnie. Identyfikator GUID wygenerowany przez klienta w celu unikatowego zidentyfikowania żądania. Możesz pominąć ten nagłówek, jeśli uwzględnisz identyfikator śledzenia w ciągu zapytania przy użyciu parametru zapytania o nazwie ClientTraceId.

Treść żądania

Treść żądania jest tablicą JSON. Każdy element tablicy jest obiektem JSON z właściwością ciągu o nazwie Text. Wykrywanie języka jest stosowane do wartości Text właściwości. Autodetection języka działa lepiej z dłuższym tekstem wejściowym. Przykładowa treść żądania wygląda następująco:

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

Obowiązują następujące ograniczenia:

• Tablica może zawierać co najwyżej 100 elementów.
• Cały tekst zawarty w żądaniu nie może przekraczać 50 000 znaków, w tym spacji.

Treść odpowiedzi

Pomyślna odpowiedź to tablica JSON z jednym wynikiem dla każdego ciągu w tablicy wejściowej. Obiekt wynikowy zawiera następujące właściwości:

• language: kod wykrytego języka.

• score: wartość zmiennoprzecinkowa wskazująca pewność wyniku. Wynik wynosi od zera do jednego i niskiej oceny wskazuje niską pewność siebie.

• isTranslationSupported: wartość logiczna, która jest prawdziwa, jeśli wykryty język jest jednym z języków obsługiwanych do tłumaczenia tekstu.

• isTransliterationSupported: wartość logiczna, która jest prawdziwa, jeśli wykryty język jest jednym z języków obsługiwanych do transliteracji.

• alternatives: tablica innych możliwych języków. Każdy element tablicy to inny obiekt o następujących właściwościach: language, scoreisTranslationSupported i isTransliterationSupported.

Przykładowa odpowiedź JSON to:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Nagłówki odpowiedzi

Nagłówki	Opis
X-RequestId	Wartość wygenerowana przez usługę w celu zidentyfikowania żądania. Służy do rozwiązywania problemów.

Kody stanu odpowiedzi

Poniżej przedstawiono możliwe kody stanu HTTP zwracane przez żądanie.

Kod stanu	Opis
200	Powodzenie.
400	Brakuje jednego z parametrów zapytania lub jest on nieprawidłowy. Popraw parametry żądania przed ponowieniu próby.
401	Nie można uwierzytelnić żądania. Sprawdź, czy poświadczenia są określone i prawidłowe.
403	Żądanie nie jest autoryzowane. Sprawdź szczegóły komunikatu o błędzie. Ten kod często wskazuje, że wszystkie bezpłatne tłumaczenia dostarczone z subskrypcją próbną zostały użyte.
429	Serwer odrzucił żądanie, ponieważ klient przekroczył limity żądań.
500	Wystąpił nieoczekiwany błąd. Jeśli błąd będzie się powtarzać, zgłoś go z: datą i godziną awarii, identyfikatorem żądania z nagłówka odpowiedzi i identyfikatorem klienta z nagłówka X-RequestIdX-ClientTraceIdżądania .
503	Serwer jest tymczasowo niedostępny. Ponów próbę żądania. Jeśli błąd będzie się powtarzać, zgłoś go z: datą i godziną awarii, identyfikatorem żądania z nagłówka odpowiedzi i identyfikatorem klienta z nagłówka X-RequestIdX-ClientTraceIdżądania .

Jeśli wystąpi błąd, żądanie zwraca odpowiedź błędu JSON. Kod błędu to 6-cyfrowy numer łączący 3-cyfrowy kod stanu HTTP, po którym następuje 3-cyfrowy numer w celu dalszego kategoryzowania błędu. Typowe kody błędów można znaleźć na stronie dokumentacji usługi Translator w wersji 3.

Przykłady

W poniższym przykładzie pokazano, jak pobrać języki obsługiwane na potrzeby tłumaczenia tekstu.

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