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