1. Подписка на услугу
1.1. Описание подписки на услугу.
Подписка на услугу является механизмом предоставления доступа к определенным услугам и/или сервисам Агентства по уникальному коду доступа (или без него) с отслеживанием времени начала и завершение предоставления услуги. Описание услуг с их датами начала и завершения, а также возможностью получения кода доступа находится в личном кабинете пользователя сайта в разделе «Подписки».
1.2. Код доступа.
Код доступа представляет собой уникальный для каждой услуги код, необходимый для указания при использовании некоторых услуг.
2. Виды подписок
2.1. Подписка на доступ к веб-сервису предоставления информации о рейтинговой деятельности.
Доступ к веб-сервису предоставления информации о рейтинговой деятельности посредством использования SOAP или REST архитектуры.
2.2. Подписка на выгрузку данных с сайта в формате Excel.
Доступа к возможности получение информации о рейтинговой деятельности в формате Excel через форму «Экспорт» рейтинг-листа на сайте Агентства.
3. Техническое описание
3.1. Подписка на доступ к веб-сервису предоставления информации о рейтинговой деятельности.
3.1.1. Виды веб-сервисов.
3.1.1.1. SOAP.
https://raexpert.ru/soap/service/ExpertRaServicesServer.php?wsdl&hash=код_доступа
Ссылка на контракт WSLD – предоставляет описание методов для работы с сервисом.
3.1.1.2. REST.
https://raexpert.ru/soap/service/export/?hash=код_доступа
Реализует предоставление информации посредством GET-запросов.
3.1.2. Методы веб-сервисов.
3.1.2.1. Получение списка доступных типов рейтингов.
Метод: getRatingAvailableList()
Пример GET-запроса:
https://raexpert.ru/soap/service/export/?hash=код_доступа&method=getRatingAvailableList
Ответ – строка в формате XML, в котором один элемент:
<rating_name>Рейтинги кредитоспособности банков</rating_name> - наименование типа рейтинга
<rating_ident>bankcredit</rating_ident> - идентификатор типа рейтинга
</item>
3.1.2.2. Получение рейтинг-листа на дату по типу рейтинга.
Метод: getRatingListOnDate(rating_ident, date, lang_id, cancelled)
Пример GET-запроса:
Аргументы:
- rating_ident — строка, идентификатор типа рейтинга, описан в методе
- getRatingAvailableList(), при указании идентификатор all выбираются все доступные типы рейтингов
- date — строка, дата в формате dd.mm.yyyy
- lang_id — число, 1 - русский язык, 0 - английский язык
- cancelled — 1 - предоставлять отозванные рейтинговые действия, 0 - не предоставлять
Ответ – строка в формате XML, в котором один элемент:
<id>105634</id> - уникальный идентификатор объекта рейтингования
<object_name>Банк «Аверс»</object_name> - наименование объекта рейтингования
<object_url>https://raexpert.ru/database/companies/aversbank</object_url> - ссылка на объект рейтингования
<national_rating>ruA+</national_rating> - рейтинг по национальной шкале
<national_rating_date>28.09.2017</national_rating_date> - дата рейтингового действия по национальной шкале
<national_prognoz_date>28.09.2017</national_prognoz_date> - дата прогноза по национальной шкале
<national_prognoz_rating_release_url>https://raexpert.ru/releases/2017/Sep28a</national_prognoz_rating_release_url> - пресс-релиз по прогнозу по национальной шкале
<license_cb_rf>415</license_cb_rf> - Лицензия ЦБ РФ
<kpp>165501001</kpp> - КПП
</item>
Набор элементов в ответе зависит от типа рейтинга, объекта рейтингования, рейтиновых событий на дату.
3.1.2.3. Получение рейтинговых действий на дату по типу рейтинга.
Метод: getRatingActionsListOnDate(rating_ident, date, lang_id, cancelled)
Пример GET-запроса:
https://raexpert.ru/soap/service/export/?hash=код_доступа&method=getRatingActionsListOnDate&rating_ident=bankcredit&date=27.10.2017&lang_id=1&cancelled=1
Аргументы:
- rating_ident — строка, идентификатор типа рейтинга, описан в методе getRatingAvailableList(), при указании идентификатор all выбираются все доступные типы рейтингов
- date — строка, дата в формате dd.mm.yyyy
- lang_id — число, 1 - русский язык, 0 - английский язык
- cancelled — 1 - предоставлять отозванные рейтинговые действия, 0 - не предоставлять
Ответ – строка в формате XML, в котором один элемент:
<id>136450</id> - уникальный идентификатор объекта рейтингования
<object_name>НПФ РГС</object_name> - наименование объекта рейтингования
<object_url>https://raexpert.ru/database/companies/npf_rgs</object_url> - ссылка на объект рейтингования
<national_rating>ruBBB+</national_rating> - рейтинг по национальной шкале
<national_rating_date>27.10.2017</national_rating_date> - дата рейтингового действия по национальной шкале
<national_rating_release_url>https://raexpert.ru/releases/2017/Oct27</national_rating_release_url> - пресс-релиз рейтингового действия по национальной шкале
<national_prognoz>стабильный</national_prognoz> - прогноз по национальной шкале
<national_prognoz_date>27.10.2017</national_prognoz_date> - дата прогноза по национальной шкале
<national_prognoz_rating_release_url>https://raexpert.ru/releases/2017/Oct27</national_prognoz_rating_release_url> - пресс-релиз по прогнозу по национальной шкале
<inn>7730001909</inn> - ИНН
<ogrn>1147799011007</ogrn> - ОГРН
<kpp>773001001</kpp> - Лицензия ЦБ РФ
<okpo>59616713</okpo> - КПП
</item>
Набор элементов в ответе зависит от типа рейтинга, объекта рейтингования, рейтиновых событий на дату.
3.1.3. Ограничения.
Не допускается запрос информации чаще раза в 5 секунд.