Получение статуса готовности файла
Обновлено 30 июля 2025
Запрос позволяет получить статус о готовности файла для скачивания.
Для получения статуса необходимо отправить POST-запрос /fintech/api/v1/files/downloadState с токеном доступа (access_token) пользователя в параметре Authorization заголовка и идентификаторами файлов (fileId).
В параметре scope ссылки авторизации пользователя должен быть указан сервис FILES для получения доступа к этому запросу.
Запрос
Ответы
Ok
Response Headers
X-Request-Id
Уникальный идентификатор запроса.
Bad Request
| Cause | Message | Description |
|---|---|---|
| DESERIALIZATION_FAULT | Неверный формат запроса | Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в response в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос. |
| VALIDATION_FAULT | Ошибка валидации | Данные не соответствуют требованиям валидации. Сведения о некорректных атрибутах request содержатся в массивах fieldNames и checks. Подробные требования к атрибутам описаны в request ресурса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос. |
Response Headers
X-Request-Id
Уникальный идентификатор запроса.
Unauthorized
Response Headers
X-Request-Id
Уникальный идентификатор запроса.
Forbidden
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
Response Headers
X-Request-Id