Своевременность получения данных о рейтингах и рейтинговых действиях не менее важный фактор, чем и само качество рейтинговых оценок
Подписка на услугу по выгрузке рейтинговых данных позволяет оперативно в автоматическом режиме следить за изменениями рейтинг-листа агентства с возможностью сортировки по типу рейтинга и дате, в том числе в ретроспективе.
Информация о рейтингах обновляется в течение суток по мере выхода пресс-релизов о рейтинговых действиях.
Варианты получения услуги:
- Подписка на доступ к веб-сервису предоставления информации о рейтинговой деятельности
Доступ к веб-сервису предоставления информации о рейтинговой деятельности посредством использования SOAP или REST архитектуры.
- Подписка на выгрузку данных с сайта в формате Excel
Доступ к возможности получения информации о рейтинговой деятельности в формате Excel через форму «Экспорт» рейтинг-листа на сайте Агентства.
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-запроса:
Аргументы:
- 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 секунд.
3.1.4. Описание ошибок в ответах сервера
Общие ошибки:
- Аутентификация не удалась, пожалуйста, укажите верные данные или проверьте активность подписки!
- Название метода некорректно!
- Нет передан метод для вызова!
- Указан пустой код услуги!
- Запросы на получение информации разрешены не чаще раза в [x] секунд!
Метод getRatingListOnDate:
- Ошибка: Не указан идентификатор рейтинга!
- Ошибка: Указан неверный идентификатор рейтинга!
- Ошибка: Указана несуществующая дата! / Получено: 27.13.2017
- Ошибка: Формат даты не соответствует ожидаемому! [формат даты: dd.mm.yyyy] / Получено: 27.10.20177
- Ошибка: Указана дата в будущем! / Получено: 27.10.2025
Метод getRatingActionsListOnDate:
- Ошибка: Не указан идентификатор рейтинга!
- Ошибка: Указан неверный идентификатор рейтинга!
- Ошибка: Указана несуществующая дата! / Получено: 27.13.2017
- Ошибка: Формат даты не соответствует ожидаемому! [формат даты: dd.mm.yyyy] / Получено: 27.10.20177
- Ошибка: Указана дата в будущем! / Получено: 27.10.2025
