Получение ссылки на скачивание выписки
Запрос позволяет получить ссылку для загрузки печатной формы файла выписки по ранее сформированной задаче.
Выписка в канале Sber API доступна за предыдущие 5 лет + текущий год. За выпиской глубиной более 5 лет, рекомендуем обратиться в офис банка.
Для получения ссылки на загрузку необходимо отправить GET-запрос /v1/statement/tasks-for-download/{taskId} с токеном доступа (access_token) пользователя в параметре Authorization заголовка и идентификатором задачи (taskId) в path-параметре.
В параметре scope ссылки авторизации пользователя должен быть указан сервис FILES для получения доступа к этому запросу.
После получения ответа 200 OK со статусом готовности файла к скачиванию EXECUTED, платформа осуществляет скачивание файла по предоставленному URL.
Обратите внимание, что для успешного выполнения этого запроса требуется наличие установленного TLS-сертификата на платформе.
Загруженный файл сохраните в базе данных платформы. Это действие позволит организовать эффективное хранение и управление доступом к файлам.
Платформа предоставляет пользователям доступ к файлам из своей базы данных. Это гарантирует, что пользователи не столкнутся с проблемами доступа, связанными с отсутствием TLS-сертификата на их устройствах.
Для тестирования сценариев используйте фиксированные значения taskId.
1. Чтобы получить положительный ответ с ссылкой для скачивание, нужно в taskId передать значение 569967764111112.
2. Чтобы получить положительный ответ с истекшей (прошло > 24 часов) ссылкой для скачивание, нужно в taskId передать значение 569967764111113.
3. Чтобы получить ошибку при формировании выписки, нужно в taskId передать значение 569967764111114.
4. Чтобы получить сообщение о том, что выписка в процессе формирования, нужно в taskId передать произвольное значение.
5. Чтобы получить ошибку "Задача не найдена", нужно в taskId передать значение 569967764111111.
6. Чтобы получить неожиданный статус формирования выписки, нужно в taskId передать значение 569967764111118.
7. Чтобы получить сообщение о недоступности сервиса, нужно в taskId передать значение 569967764111118.
Запрос
Ответы
Успешный код возврата
Запрос принят
Ошибка в запросе или его жизненном цикле
Не авторизован
Запрещено
Запрошенная выписка недоступна
В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact Serialization
Превышен лимит запросов
Внутренняя ошибка сервера
Сервис временно недоступен