Описание запросов
Обновлено 3 августа 2023
Порядок вызова сервиса:
- Нужно получить OAUTH-токен в соответствии с инструкцией для запроса списка ИНН, давших согласия на трансляцию рейтинга. В атрибуте scope указать
https://api.sberbank.ru/rating/agreement.read - С токеном сделать вызов на получение списка ИНН компаний, давших согласия на трансляцию рейтинга данному партнеру. Важно указывать период за один день, т.к. в ответном сообщении есть ограничение по количеству передаваемых в списке ИНН. Для обращения к API необходимо отправлять запрос на промышленный контур https://mc.api.sberbank.ru/prod добавляя путь prod/ratings/agreement/v1/agreement
- Получить OAUTH-токен для запроса рейтинга в соответствии с инструкцией. В атрибуте scope указать
https://api.sberbank.ru/rating/partner/legal. - Для каждого ИНН из списка из п. 2 сделать запрос на расчет рейтинга. Для обращения к API необходимо отправлять запрос на промышленный контур https://mc.api.sberbank.ru/prod добавляя путь ratings/partner/legal/v1/rating/partner?
Пример запроса списка ИНН, давших согласия на трансляцию рейтинга
GET https://mc.api.sberbank.ru/prod/ratings/agreement/v1/agreement
Connection: keep-alive
Authorization: Bearer 761d8fd8-717f-4cfd-b442-bb55473c3872 - подставить полученный токен
x-Introspect-RqUID: c8fc1ad23e00a90e1385d4d1a4a113df
accept: application/json
from_agreement_date: 2021-12-15
to_agreement_date: 2021-12-16
User-Agent: Apache-HttpClient
Описание состава заголовков запроса списка ИНН, давших согласия на трансляцию рейтинга
| Наименование атрибута | Передается | Описание атрибута | Обязательность атрибута |
|---|---|---|---|
| x-Introspect-RqUID | Заголовок | Уникальный идентификатор сообщения, «maxLength=32 и pattern=([0-9]|[a-f]|[A-F]){32})», переданный во входящем сообщении. Необходим для журналирования входящих вызовов и удобства разбора инцидентов. Чтобы обеспечить уникальность, можно использовать стандартные библиотеки и классы для генерации UUID/GUID (https://ru.wikipedia.org/wiki/UUID), убрав из результата разделители «-». например: 743c572ab3e876c5f9acb8c0a0746f26 | Да |
| Authorization | Заголовок | Полученный ранее токен. В начало необходимо добавить «Bearer», например: Bearer 761d8fd8-717f-4cfd-b442-bb55473c3872 | Да |
| accept | Заголовок | Принимает значение "application/json" | Да |
| from_agreement_date | Заголовок | дата предоставления согласия с | Да |
| to_agreement_date | Заголовок | дата предоставления согласия по (включительно). Важно указывать период за один день, т к в ответном сообщении есть ограничение по количеству передаваемых в списке ИНН. | Да |
Пример запроса рейтинга
GET https://mc.api.sberbank.ru/prod/ratings/partner/legal/v1/rating/partner?legal_inn=1111111111&model_id=5
Connection: keep-alive
Authorization: Bearer 2017c574-1962-41a5-a46f-8aad0674b929 - подставить полученный токен
x-Introspect-RqUID: 317ee862982c3f742ebf9f809a37f537
accept: application/json
User-Agent: Apache-HttpClient
Описание состава заголовков запроса рейтинг
| Наименование атрибута | Передается | Описание атрибута | Обязательность атрибута |
|---|---|---|---|
| x-Introspect-RqUID | Заголовок | Уникальный идентификатор сообщения, «maxLength=32 и pattern=([0-9]|[a-f]|[A-F]){32})», переданный во входящем сообщении. Необходим для журналирования входящих вызовов и удобства разбора инцидентов. Чтобы обеспечить уникальность, можно использовать стандартные библиотеки и классы для генерации UUID/GUID (https://ru.wikipedia.org/wiki/UUID), убрав из результата разделители «-». например: 743c572ab3e876c5f9acb8c0a0746f26 | Да |
| Authorization | Заголовок | Полученный ранее токен. В начало необходимо добавить «Bearer», например: Bearer 761d8fd8-717f-4cfd-b442-bb55473c3872 | Да |
| accept | Заголовок | Принимает значение "application/json". | Да |
| legal_inn=1111111111 | Параметр запроса | Нужно подставить ИНН, по которому требуется произвести расчет. | Да |
| model_id=5 | Параметр запроса | Номер модели расчета. Менять значение 5 не нужно, передавать как есть. | Да |