Translator 3.0: Transliteracja

Konwertuje tekst w jednym języku z jednego skryptu na inny skrypt.

Adres URL żądania

Wyślij żądanie POST do:

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

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

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.
language	Wymagany parametr. Określa język tekstu, który ma być konwertowany z jednego skryptu na inny. Możliwe języki są wymienione w transliteration zakresie uzyskanym przez odpytywanie usługi pod kątem obsługiwanych języków.
fromScript	Wymagany parametr. Określa skrypt używany przez tekst wejściowy. Wyszukaj obsługiwane języki przy użyciu transliteration zakresu, aby znaleźć skrypty wejściowe dostępne dla wybranego języka.
toScript	Wymagany parametr. Określa skrypt wyjściowy. Wyszukaj obsługiwane języki przy użyciu transliteration zakresu, aby znaleźć skrypty wyjściowe dostępne dla wybranej kombinacji języka wejściowego i skryptu wejściowego.

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 generowany przez klienta w celu unikatowego zidentyfikowania żądania. Ten nagłówek można pominąć, jeśli w ciągu zapytania dołączysz identyfikator śledzenia 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, która reprezentuje ciąg do konwersji.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

Obowiązują następujące ograniczenia:

• Tablica może zawierać co najwyżej 10 elementów.
• Wartość tekstowa elementu tablicy nie może przekraczać 1000 znaków, w tym spacji.
• Cały tekst zawarty w żądaniu nie może przekraczać 5000 znaków, w tym spacji.

Treść odpowiedzi

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

• text: ciąg, który wynika z konwertowania ciągu wejściowego na skrypt wyjściowy.

• script: ciąg określający skrypt używany w danych wyjściowych.

Przykładowa odpowiedź JSON to:

[
    {"text":"konnnichiha","script":"Latn"},
    {"text":"sayounara","script":"Latn"}
]

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 ponowną próbą.
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 wykorzystane.
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ą niepowodzenia, 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ą niepowodzenia, identyfikatorem żądania z nagłówka odpowiedzi i identyfikatorem klienta z nagłówka X-RequestIdX-ClientTraceIdżądania .

Jeśli wystąpi błąd, żądanie zwróci również odpowiedź o błędzie JSON. Kod błędu to 6-cyfrowy numer łączący 3-cyfrowy kod stanu HTTP, po którym następuje 3-cyfrowa liczba 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 przekonwertować dwa japońskie ciągi na rzymsko-japoński.

Ładunek JSON dla żądania w tym przykładzie:

[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]

Jeśli używasz biblioteki cURL w oknie wiersza polecenia, które nie obsługuje znaków Unicode, użyj następującego ładunku JSON i zapisz go w pliku o nazwie request.txt. Pamiętaj, aby zapisać plik z UTF-8 kodowaniem.

curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d @request.txt