Аутентификация в API v1
Статья создана
Обновлена 1 ноября 2024 г.
Для работы с Yandex Search API при помощи API v1 необходимо отправлять запросы к API от имени сервисного аккаунта. API v1 поддерживает только аутентификацию с помощью API-ключей.
Важно
Если ваш API-ключ мог быть скомпрометирован, отзовите его и выпустите новый.
-
Получите идентификатор каталога сервисного аккаунта.
-
Полученные значения передавайте в каждом запросе:
GET-запросыPOST-запросыВ GET-запросах передавайте значения идентификатора каталога и API-ключа в URL запроса в полях
folderid
иapikey
:curl 'https://yandex.<домен>/search/xml?folderid=<идентификатор_каталога>&apikey=<значение_API-ключа>&query=<текст_поискового_запроса>'
В POST-запросах передавайте значение API-ключа в заголовке запроса
Authorization
в следующем формате:curl \ --request POST \ --header "Authorization: Api-Key <API-ключ>" \ ...
Идентификатор каталога передавайте в URL запроса в поле
folderid
:https://yandex.<домен>/search/xml?folderid=<идентификатор_каталога>