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

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

  1. Получите IAM-токен для аккаунта на Яндексе или федеративного аккаунта, необходимый для аутентификации. Передавайте полученный токен в заголовке Authorization каждого запроса в формате:

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

  2. Назначьте пользователю роль search-api.webSearch.user на каталог, который будет использоваться для запросов к Yandex Search API. Идентификатор каталога должен передаваться в теле каждого запроса в поле folderId (folder_id).

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

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

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

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

      Authorization: Api-Key <API-ключ>
  2. Назначьте сервисному аккаунту роль search-api.webSearch.user на каталог, в котором он был создан и который будет использоваться для запросов к Yandex Search API. Идентификатор каталога должен передаваться в теле каждого запроса в поле folderId (folder_id).

См. также

Предыдущая
Получить список регионов поиска
Следующая
Overview