Запрос ссылки на загрузку файла в Банк
Обновлено 21 июля 2025
POST
/v1/files/upload
Запрос позволяет получить ссылку для загрузки вашего файла на платформу Банка.
Для получения статуса необходимо отправить POST-запрос /fintech/api/v1/files/upload с токеном доступа (access_token) пользователя в параметре Authorization заголовка и параметрами загружаемого файла в теле.
В параметре scope ссылки авторизации пользователя должен быть указан сервис FILES для получения доступа к этому запросу.
Запрос
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
Уникальный идентификатор запроса.
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...
Это полезный материал?