Получение списка контрагентов по рублевым операциям
/v1/correspondents/rur
Запрос позволяет получить список контрагентов по рублевым операциям.
Для получения списка контрагентов необходимо отправить GET-запрос /fintech/api/v1/correspondents/rur с токеном доступа (access_token) пользователя в параметре Authorization заголовка и номером страницы (page) в query-параметре.
В параметре scope ссылки авторизации пользователя должен быть указан сервис GET_CORRESPONDENTS для получения доступа к этому запросу.
Для обращения к ресурсу необходимо отправлять запрос на:
- Тестовый контур
https://iftfintech.testsbi.sberbank.ru:9443 - Промышленный контур
https://fintech.sberbank.ru:9443
На запрос первой страницы в ответе вернется список объектов (если они существуют на выбранной странице) и контейнер links с параметром (href) на следующую страницу и признаком "rel": "next".
На запрос второй страницы в ответе вернется список объектов и контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Получение последующих страниц производится по аналогии.
Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
Запрос
Успех
Ошибка запроса
| Cause | Message | Description |
|---|---|---|
| DESERIALIZATION_FAULT | Неверный формат запроса | Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос. |
Не авторизован
| Cause | Message | Description |
|---|---|---|
| UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
| Некорректное значение Access Token | Указан некорректный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
Доступ запрещен
| Cause | Message | Description |
|---|---|---|
| ACTION_ACCESS_EXCEPTION | Операция не может быть выполнена: доступ к ресурсу запрещен | Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция GET_CORRESPONDENTS. Необходимо добавить эту операцию в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token. |
| Операция не может быть выполнена: приостановлено оказание услуг | ||
| Операция не может быть выполнена: организация заблокирована по идентификации | ||
| Операция не может быть выполнена: организация заблокирована | ||
| Операция не может быть выполнена: пользователь заблокирован |
Слишком много запросов
| Cause | Message | Description |
|---|---|---|
| TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное вре мя превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
Внутренняя ошибка сервера
| Cause | Message | Description |
|---|---|---|
| UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
Сервис временно недоступен