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