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

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

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

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

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

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

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

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

BODY

Атрибут

Описание

array of objectoptional

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

url

stringoptional

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

method

stringoptional

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

stringoptional

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

url

stringoptional

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

method

stringoptional

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

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

1{
2  "downloadFileLinks": [
3    {
4      "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",
5      "method": "GET",
6      "detachedSignatureLink": {
7        "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",
8        "method": "GET"
9      }
10    },
11    {
12      "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",
13      "method": "GET",
14      "detachedSignatureLink": {
15        "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",
16        "method": "GET"
17      }
18    }
19  ]
20}

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

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

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

HEADERS

Атрибут

Описание

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

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

Пример запроса

1curl -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 \
2  -H 'Accept: */*' \
3  -H 'Content-Length: 1024' \
4  -H 'Content-Type: application/octet-stream'

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

1Нет тела ответа

Нет тела ответа

error

stringrequired

Код ошибки

Пример ошибки 400 (Bad Request)

1<?xml version="1.0" encoding="UTF-8"?>
2<Error>
3  <Code>string</Code>
4  <Message>string</Message>
5  <BucketName>secure-file-transfer.incoming-files.to-processing</BucketName>
6    <Key>12345678-90AB-CDEF-1234-1234567890AB</Key>
7</Error>

error

stringrequired

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

Пример ошибки 403 (Forbidden)

1<?xml version="1.0" encoding="UTF-8"?>
2<notagname>
3  <Code>AccessDenied</Code>
4  <Message>Request has expired</Message>
5  <BucketName>secure-file-transfer.incoming-files.to-processing</BucketName>
6    <Key>12345678-90AB-CDEF-1234-1234567890AB</Key>
7</notagname>

error

stringrequired

Код ошибки

Пример ошибки 404 (Not Found)

1<?xml version="1.0" encoding="UTF-8"?>
2<notagname>
3  <Code>NoSuchBucket</Code>
4  <Message>The specified bucket does not exist</Message>
5  <BucketName>secure-file-transfer.incoming-files.to-processing</BucketName>
6    <Key>12345678-90AB-CDEF-1234-1234567890AB</Key>
7</notagname>

error

stringrequired

Код ошибки

Пример ошибки 500 (Internal Server Error)

1<?xml version="1.0" encoding="UTF-8"?>
2<Error>
3  <Code>InternalError</Code>
4  <Message>An internal error occurred. Try again.</Message>
5  <BucketName>secure-file-transfer.incoming-files.to-processing</BucketName>
6    <Key>12345678-90AB-CDEF-1234-1234567890AB</Key>
7</Error>