Получение ссылки на скачивание

Обновлено 30 июля 2025

Запрос позволяет получить ссылку для загрузки печатной формы файла выписки по ранее сформированной задаче.

Для получения ссылки на загрузку необходимо отправить GET-запрос /fintech/api/v1/files/tasks-for-download/{taskId} с токеном доступа (access_token) пользователя в параметре Authorization заголовка и идентификатором задачи (taskId) в path-параметре.

В параметре scope ссылки авторизации пользователя должен быть указан сервис FILES для получения доступа к этому запросу.

После получения ответа 200 OK со статусом готовности файла к скачиванию EXECUTED, платформа осуществляет скачивание файла по предоставленному URL.

Обратите внимание, что для успешного выполнения этого запроса требуется наличие установленного TLS-сертификата на платформе.

Загруженный файл сохраните в базе данных платформы. Это действие позволит организовать эффективное хранение и управление доступом к файлам.

Платформа предоставляет пользователям доступ к файлам из своей базы данных. Это гарантирует, что пользователи не столкнутся с проблемами доступа, связанными с отсутствием TLS-сертификата на их устройствах.

Запрос

Ответы

• 200
• 202
• 400
• 401
• 403
• 404
• 415
• 429
• 500
• 503

Успешный код возврата

Запрос принят

Ошибка в запросе или его жизненном цикле

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

Loading...