B2BB2CH2H

Скачивание файла

1

Получите ссылку для скачивания файла

Подробнее в пункте "Получение ссылки"

2

Выполните запрос на скачивание файла

Подробнее в пункте "Запрос на скачивание"

3

Скачивание файла

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

Первым шагом необходимо получить ссылку на скачивание файла в рамках вашего взаимодействия. Ниже приведен пример получаемой вами ссылки для скачивания файла с описанием параметров.

BODY
Атрибут
Описание
array of objectoptional

Ссылка для скачивания файла из Банка

url
stringoptional

Ссылка для скачивания файла

method
stringoptional

Метод, используемый для скачивания файла

stringoptional

Открепленная ЭЦП содержимого файла

url
stringoptional

Ссылка для скачивания файла открепленной ЭЦП

method
stringoptional

Метод для скачивания открепленной ЭЦП

Пример ссылок на скачивание
{
  "downloadFileLinks": [
    {
      "url": "https://baas.alfabank.ru/filebox/secure-file-transfer.incoming-files.to-processing/12345678-90ab-cdef-1234-1234567890ab?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230608T152952Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=secure-file-transfer%2F20230608%2Fdev%2Fs3%2Faws4_request&X-Amz-Signature=e78c051fcff1017a68795620c20e50db33126ab8374c2ee9644ef4743b3625c6",
      "method": "GET",
      "detachedSignatureLink": {
        "url": "https://baas.alfabank.ru/filebox/secure-file-transfer.incoming-files.to-processing/12345678-90ab-cdef-1234-1234567890ab.sign?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230608T152952Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=secure-file-transfer%2F20230608%2Fdev%2Fs3%2Faws4_request&X-Amz-Signature=36ef1ccf28bdf6e54710fc3c1dd235c8f383275c2bbb0c9db365da272d3c24a8",
        "method": "GET"
      }
    },
    {
      "url": "https://baas.alfabank.ru/filebox/secure-file-transfer.incoming-files.to-processing/12345678-90ab-cdef-1234-1234567890ac?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230608T152952Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=secure-file-transfer%2F20230608%2Fdev%2Fs3%2Faws4_request&X-Amz-Signature=e78c051fcff1017a68795620c20e50db33126ab8374c2ee9644ef4743b3625c6",
      "method": "GET",
      "detachedSignatureLink": {
        "url": "https://baas.alfabank.ru/filebox/secure-file-transfer.incoming-files.to-processing/12345678-90ab-cdef-1234-1234567890ac.sign?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230608T152952Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=secure-file-transfer%2F20230608%2Fdev%2Fs3%2Faws4_request&X-Amz-Signature=36ef1ccf28bdf6e54710fc3c1dd235c8f383275c2bbb0c9db365da272d3c24a8",
        "method": "GET"
      }
    }
  ]
}

Запрос на скачивание

Для скачивания файла по полученной ссылке необходимо выполнить http запрос методом, указанным в параметре method , и полученной в параметре url ссылкой https://baas.alfabank.ru/filebox/{bucketName}/{objectKey} с параметрами запроса.

Параметры запроса

HEADERS
Атрибут
Описание
Accept
stringrequired

/

Content-Length
stringrequired

1024

Content-Type
stringoptional

application/octet-stream

PATH
Атрибут
Описание
bucketName
stringrequired

Имя bucket'а для сохранения файла

objectKey
stringrequired

Имя файла

QUERY
Атрибут
Описание
X-Amz-Date
stringrequired

Дата и время генерации ссылки

X-Amz-Expires
integerrequired

TTL ссылки (указанный в секундах) относительно времени её создания, указанной в X-Amz-Date

X-Amz-Credential
stringrequired

Данные об учетной записи s3 и подписи запроса

X-Amz-Algorithm
stringrequired

Алгоритм подписи запроса

X-Amz-Signature
stringrequired

Подпись запроса

Content-Length
integerrequired

Размер содержимого файла

Пример запроса
curl -X GET https://baas.alfabank.ru/filebox/secure-file-transfer.incoming-files.to-processing/12345678-90ab-cdef-1234-1234567890ab?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230608T152952Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=secure-file-transfer%2F20230608%2Fdev%2Fs3%2Faws4_request&X-Amz-Signature=e78c051fcff1017a68795620c20e50db33126ab8374c2ee9644ef4743b3625c6 \
  -H 'Accept: */*' \
  -H 'Content-Length: 1024' \
  -H 'Content-Type: application/octet-stream'

Параметры ответа

Нет тела ответа
Нет тела ответа
error
stringrequired

Код ошибки

Пример ошибки 400 (Bad Request)
<?xml version="1.0" encoding="UTF-8"?>
<Error>
	<Code>string</Code>
	<Message>string</Message>
	<BucketName>secure-file-transfer.incoming-files.to-processing</BucketName>
	<Key>12345678-90AB-CDEF-1234-1234567890AB</Key>
</Error>
error
stringrequired

Код ошибки. Время жизни ссылки истекло / Используется некорректный метод или ссылка изменена

Пример ошибки 403 (Forbidden)
<?xml version="1.0" encoding="UTF-8"?>
<notagname>
	<Code>AccessDenied</Code>
	<Message>Request has expired</Message>
	<BucketName>secure-file-transfer.incoming-files.to-processing</BucketName>
	<Key>12345678-90AB-CDEF-1234-1234567890AB</Key>
</notagname>
error
stringrequired

Код ошибки

Пример ошибки 404 (Not Found)
<?xml version="1.0" encoding="UTF-8"?>
<notagname>
	<Code>NoSuchBucket</Code>
	<Message>The specified bucket does not exist</Message>
	<BucketName>secure-file-transfer.incoming-files.to-processing</BucketName>
	<Key>12345678-90AB-CDEF-1234-1234567890AB</Key>
</notagname>
error
stringrequired

Код ошибки

Пример ошибки 500 (Internal Server Error)
<?xml version="1.0" encoding="UTF-8"?>
<Error>
	<Code>InternalError</Code>
	<Message>An internal error occurred. Try again.</Message>
	<BucketName>secure-file-transfer.incoming-files.to-processing</BucketName>
	<Key>12345678-90AB-CDEF-1234-1234567890AB</Key>
</Error>
Требования и ограниченияЗагрузка файла