Как начать работать с Search API через интерфейс API v1
Воспользуйтесь инструкциями из этого раздела, если ранее вы пользовались сервисом Яндекс XML и хотите настроить свою работу в Search API через интерфейс API v1, совместимый с Яндекс XML.
Вместо API v1 рекомендуем вам использовать более современный интерфейс API v2.
Перед началом работы
Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:
- Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
- На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе
ACTIVEилиTRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.
Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.
Подробнее об облаках и каталогах.
Регистрация
-
В консоли управления выберите каталог, в котором вы будете работать с Search API, или создайте новый.
-
В списке сервисов выберите Search API.
-
Заполните поля формы:
-
Выберите Тип поиска —
Русский,ТурецкийилиМеждународный. -
Задайте как минимум один доверенный IP-адрес, с которого вы будете отправлять запросы к поисковой базе Яндекса.
Отправлять запросы к API v1 сервиса Search API можно только с одного из IP-адресов, добавленных в настройки сервиса при регистрации. При попытке выполнить запрос с незарегистрированного IP-адреса этот запрос будет отклонен.
-
-
Нажмите кнопку Сохранить.
Позднее вы сможете изменить тип поиска и список доверенных IP-адресов. Для этого в консоли управления перейдите в сервис Search API и в правом верхнем углу экрана нажмите Редактировать.
Выполните тестовый запрос в консоли управления
Чтобы в интерактивном режиме познакомиться с принципом формирования поискового запроса к API v1 сервиса Search API, воспользуйтесь специальной формой тестирования запроса:
-
В консоли управления выберите каталог, в котором вы будете работать с Search API.
-
В списке сервисов выберите Search API.
-
На панели слева выберите Тестирование запросов.
-
Выберите Метод запроса (поддерживаются методы GET и POST) и заполните поля формы.
Примечание
В тестовом запросе нельзя изменить Текст поискового запроса. Запросы отправляются с IP-адреса Яндекса от имени сервиса.
По мере изменения значений в полях формы в поле Поисковый запрос будет формироваться URL поискового запроса, соответствующего заданным значениям. Если выбран метод запроса
POST, в поле Тело запроса также будет формироваться соответствующее тело запроса. -
Нажмите Запустить тест. Результат выполнения запроса появится ниже.
-
При необходимости измените параметры, чтобы скорректировать результаты выдачи, и повторите отправку запроса.
Начните работу с сервисом
Изучив особенности формирования запросов к API v1 сервиса Search API, переходите к выполнению поисковых запросов в рабочем режиме.