Переводчик 3.0: транслитерация

Статья
06/06/2024

Преобразует текст на одном языке из одного набора символов в другой.

Запросить URL-адрес

Отправьте запрос POST на следующий адрес.

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

Ознакомьтесь с виртуальная сеть поддержкой выбранной сети и частной конечной точки службы Переводчика.

Параметры запроса

В таблице ниже приведены параметры, которые передаются в строке запроса.

Параметр запроса	Description
api-version	Обязательный параметр. Версия API, запрошенная клиентом. Необходимое значение: `3.0`.
язык	Обязательный параметр. Указывает язык текста, преобразуемого из одного набора символов в другой. Возможные языки перечисляются в области `transliteration`, получаемой путем отправки запроса к службе на предмет поддерживаемых языков.
fromScript	Обязательный параметр. Указывает набор символов, используемый во входном тексте. Определите поддерживаемые языки с помощью области `transliteration`, чтобы найти доступные входные наборы символов для выбранного языка.
toScript	Обязательный параметр. Указывает выходной набор символов. Определите поддерживаемые языки с помощью области `transliteration`, чтобы найти доступные выходные наборы символов для выбранного сочетания входного языка и входного набора символов.

Заголовки запроса:

Заголовки	Description
Заголовки проверки подлинности	Обязательный заголовок запроса. См. описание доступных способов проверки подлинности.
Тип контента	Обязательный заголовок запроса. Указывает тип содержимого для полезных данных. Возможные значения: `application/json`
content-length: 0	Необязательно. Длина текста запроса.
X-ClientTraceId	Необязательно. Созданный клиентом идентификатор GUID, позволяющий уникально идентифицировать запрос. Этот заголовок можно опустить, если в строке запроса указан идентификатор трассировки в параметре с именем `ClientTraceId`.

Текст запроса

Текст запроса является массивом в формате JSON. Каждый элемент этого массива представляет собой объект JSON со строковым свойством Text, который соответствует преобразуемой строке.

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

Действительны следующие ограничения.

Массив может содержать не более 10 элементов.
Текстовое значение элемента массива не может превышать 1000 символов, включая пробелы.
Весь текст, включенный в запрос, не может превышать 5000 символов, включая пробелы.

Текст ответа

Успешный ответ возвращается в формате массива JSON с одним результатом для каждого элемента входного массива. Объект результата содержит следующие свойства.

text: строка, которая приводит к преобразованию входной строки в выходной скрипт.
script: строка, указывающая набор символов, используемый в выходных данных.

Пример ответа в формате JSON:

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

Заголовки ответа

Заголовки	Description
X-RequestId	Значение, созданное службой для идентификации запроса и используемого для устранения неполадок.

Коды состояния ответа

Ниже приведены возможные коды состояния HTTP, которые возвращает запрос.

Код состояния	Description
200	Успешно.
400	Один из параметров запроса отсутствует или имеет недопустимое значение. Исправьте параметры запроса и повторите попытку.
401	Не удалось выполнить аутентификацию запроса. Убедитесь, что указаны допустимые учетные данные.
403	Запрос не авторизован. Подробные сведения можно найти в сообщении об ошибке. Этот код часто указывает, что используются все бесплатные переводы, предоставляемые пробной подпиской.
429	Сервер отклонил запрос, так как клиент превысил ограничения запроса.
500	Произошла непредвиденная ошибка. Если ошибка сохраняется, передайте отчет о ней, включив следующие данные: дата и время сбоя, идентификатор запроса из заголовка ответа `X-RequestId` и идентификатор клиента из заголовка запроса `X-ClientTraceId`.
503	Сервер временно недоступен. Повторите запрос. Если ошибка сохраняется, передайте отчет о ней, включив следующие данные: дата и время сбоя, идентификатор запроса из заголовка ответа `X-RequestId` и идентификатор клиента из заголовка запроса `X-ClientTraceId`.

Если возникнет ошибка, запрос также вернет ответ JSON с ошибкой. Код ошибки представляет собой число из 6 знаков, первые 3 из которых являются кодом состояния HTTP, а оставшиеся 3 цифры определяют категорию ошибки. Коды распространенных ошибок можно найти на справочной странице переводчика версии 3.

Примеры

В следующем примере показано преобразование двух строк на японском языке в транслитерацию японского текста латиницей.

Полезные данные JSON для запроса в этом примере:

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

Если вы используете cURL в окне командной строки, которое не поддерживает символы Юникода, выполните следующие полезные данные JSON и сохраните его в файл с именем request.txt. Обязательно сохраните файл в кодировке UTF-8.

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

Поделиться через