Получение ссылки на скачивание
/v1/files/tasks-for-download/{taskId}
Запрос позволяет получить ссылку для загрузки печатной формы файла выписки по ранее сформированной задаче.
Для получения ссылки на загрузку необходимо отправить GET-запрос /fintech/api/v1/files/tasks-for-download/{taskId} с токеном доступа (access_token) пользователя в параметре Authorization заголовка и идентификатором задачи (taskId) в path-параметре.
В параметре scope ссылки авторизации пользователя должен быть указан сервис FILES для получения доступа к этому запросу.
После получения ответа 200 OK со статусом готовности файла к скачиванию EXECUTED, платформа осуществляет скачивание файла по предоставленному URL.
Обратите внимание, что для успешного выполнения этого запроса требуется наличие установленного TLS-сертификата на платформе.
Загруженный файл сохраните в базе данных платформы. Это действие позволит организовать эффективное хранение и управление доступом к файлам.
Платформа предоставляет пользователям доступ к файлам из своей базы данных. Это гарантирует, что пользователи не столкнутся с проблемами доступа, связанными с отсутствием TLS-сертификата на их устройствах.
Запрос
Успешный код возврата
Запрос принят
Ошибка в запросе или его жизненном цикле
Unauthorized
| Cause | Message | Description |
|---|---|---|
| UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
| Некорректное значение Access Token | Указан некорректный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
Forbidden
| Cause | Message | Description |
|---|---|---|
| ACTION_ACCESS_EXCEPTION | Операция не может быть выполнена: доступ к ресурсу запрещен | Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция FILES. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token. |
Not Found
В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact Serialization
Too Many Requests
Internal Server Error
| Cause | Message | Description |
|---|---|---|
| UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
Service Unavailable