Создание запроса на ссылку для скачивания файла

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

POST

/v1/files/download

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

Для запуска процесса подготовки ссылки необходимо отправить POST-запрос /fintech/api/v1/files/download с токеном доступа (access_token) пользователя в параметре Authorization заголовка и идентификаторами файлов (fileId).

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

Запрос

Ответы

• 200
• 400
• 401
• 403
• 404
• 429
• 500
• 502

Ok

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Bad Request

Cause	Message	Description
DESERIALIZATION_FAULT	Неверный формат запроса	Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос.
VALIDATION_FAULT	Ошибка валидации	Данные не соответствуют требованиям валидации. Сведения о некорректных атрибутах request содержатся в массивах fieldNames и checks. Подробные требования к атрибутам описаны в request ресурса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос.

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Unauthorized

Cause	Message	Description
UNAUTHORIZED	accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х	Указан просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос.
	Некорректное значение Access Token	Указан некорректный access_token. Используйте refresh_token для обновления access_token и повторите запрос.

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Forbidden

Cause	Message	Description
ACTION_ACCESS_EXCEPTION	Операция не может быть выполнена: доступ к ресурсу запрещен	Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция FILES. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token.

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Not Found

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Too Many Requests

Cause	Message	Description
TOO_MANY_REQUESTS	Превышен лимит запросов. Повторите операцию позже.	Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Internal Server Error

Cause	Message	Description
UNKNOWN_EXCEPTION	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Bad Gateway

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Loading...

Loading...