Введение

Сервис Яндекс.Услуги предоставляет программный интерфейс (API) для поиска банковских продуктов и получения структурированных данных о банках и банковских продуктах. Сервис предоставляет информацию по следующим странам:

• Россия;
• Беларусь;
• Украина;
• Казахстан.

С помощью API можно получить информацию о следующих типах объектов:

• банки;
• вклады;
• потребительские кредиты;
• автокредиты;
• ипотека.

Все данные о банках и банковских продуктах привязаны к тому или иному региону, поскольку банковские услуги, как правило, регионализованы. Например, банк может предлагать кредит с одинаковым названием, но разными условиями для разных регионов. Поэтому все поисковые запросы по банкам и банковским продуктам в качестве обязательного параметра должны содержать название региона. В качестве названия региона может быть использовано название населенного пункта.

Использование API: рекомендации и ограничения

API Яндекс.Услуг организовано в соответствии с принципами REST. Взаимодействие с API осуществляется по протоколу HTTP. Обращение к API осуществляется посредством GET-запросов, сервис возвращает данные в XML-формате.

Каждый запрос к API состоит из следующих компонент:

• HTTP-заголовков запроса; проверяются значения заголовков Referer и Authorization, подробнее см. раздел Доступ к API.
• основного URL запроса — http://api.uslugi.yandex.ru/1.0/;
• ресурса, например, banks/credits/search;
• параметров GET-запроса.

При использовании API нужно учитывать следующие ограничения:

1. Максимальное количество обращений к API для одного клиента ограничено 10 запросами в секунду.
2. В результатах поисковых запросов выводится не более 100 банковских продуктов (точнее, первые 100 в соответствии с используемым методом сортировки).