Аутентификация в API Translate

Для работы с API Translate необходимо отправлять данные для аутентификации в каждом запросе. Способ аутентификации зависит от типа аккаунта, от имени которого вы будете отправлять запросы:

  1. Получите IAM-токен для аккаунта на Яндексе, федеративного или локального аккаунта. Идентификатор каталога должен передаваться в теле каждого запроса в поле folderId.

    Передавайте полученный токен в заголовке Authorization каждого запроса в формате:

    Authorization: Bearer <IAM-токен>

  2. Получите идентификатор любого каталога, на который у вашего аккаунта есть роль ai.translate.user или выше. Идентификатор каталога должен передаваться в теле каждого запроса в поле folderId.

  1. Выберите один из способов аутентификации:

    • Получите IAM-токен. Передавайте IAM-токен в заголовке Authorization в формате:

      Authorization: Bearer <IAM-токен>

    • Создайте API-ключ. Передайте API-ключ в заголовке Authorization в следующем формате:

      Authorization: Api-Key <API-ключ>

  2. Назначьте сервисному аккаунту роль ai.translate.user или выше на каталог, в котором он был создан.

    Не указывайте в запросах идентификатор каталога — сервис использует каталог, в котором был создан сервисный аккаунт.

См. также

Предыдущая
Обзор
Следующая
Overview