Получение списка поддерживаемых языков
Перед началом работы
Чтобы воспользоваться примерами, установите cURL
Для работы с API Translate необходимо отправлять данные для аутентификации в каждом запросе. Способ аутентификации зависит от типа аккаунта, от имени которого вы будете отправлять запросы:
-
Получите IAM-токен для аккаунта на Яндексе или федеративного аккаунта, необходимый для аутентификации. Передавайте полученный токен в заголовке
Authorization
каждого запроса в формате:Authorization: Bearer <IAM-токен>
-
Получите идентификатор любого каталога, на который у вашего аккаунта есть роль
ai.translate.user
или выше. Идентификатор каталога должен передаваться в теле каждого запроса в полеfolderId
.
-
Выберите один из способов аутентификации:
-
Получите IAM-токен. Передавайте IAM-токен в заголовке
Authorization
в формате:Authorization: Bearer <IAM-токен>
-
Создайте API-ключ. Передайте API-ключ в заголовке
Authorization
в следующем формате:Authorization: Api-Key <API-ключ>
-
-
Назначьте сервисному аккаунту роль
ai.translate.user
или выше на каталог, в котором он был создан.Не указывайте в запросах идентификатор каталога — сервис использует каталог, в котором был создан сервисный аккаунт.
Пример ниже разработан для выполнения в операционных системах MacOS и Linux. Чтобы выполнить его в системе Windows, ознакомьтесь с особенностями работы с Bash в Microsoft Windows.
Получить список поддерживаемых языков
Получите список поддерживаемых языков с помощью метода listLanguages:
export FOLDER_ID=<идентификатор_каталога>
export IAM_TOKEN=<IAM-токен>
curl \
--request POST \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${IAM_TOKEN}" \
--data "{\"folderId\": \"${FOLDER_ID}\"}" \
"https://translate.api.cloud.yandex.net/translate/v2/languages"
Где:
FOLDER_ID
— идентификатор каталога, полученный перед началом работы.IAM_TOKEN
— IAM-токен, полученный перед началом работы.
Ответ будет содержать список языков с названиями на соответствующем языке:
{
"languages": [
{
"code": "az",
"name": "azərbaycan"
},
{
"code": "sq",
"name": "shqip"
},
{
"code": "am",
"name": "አማርኛ"
},
{
"code": "en",
"name": "English"
},
...
]
}