Skip to content

Скачать файл

Request

Администратор может читать собственные доступные файлы и делегированные CARD/BLOG/AVATAR своего салона при наличии соответствующего права. Приватные документы владельца салона не становятся доступными администратору.

Медиа отзывов с purpose REVIEW и фотографии с purpose CARD доступны любому авторизованному пользователю по media_ids: FULL — для фото и видео, PREVIEW — только для фото. Для приватных purpose проверяются дополнительные права доступа. По умолчанию возвращает redirect на файл. Если передать redirect=false, возвращает JSON с временной ссылкой в data.url. Этот режим полезен браузерным клиентам, которым нельзя читать cross-origin redirect через fetch.

Для обычного файла endpoint всегда отвечает HTTP 302 при redirect=true. Location ведёт на временную подписанную ссылку /api/file/content/{id} независимо от места хранения. При redirect=false тот же адрес возвращается в data.url. Endpoint содержимого отдаёт локальный файл или перенаправляет на object storage после фонового переноса. Подписанная ссылка может использоваться без JWT до истечения срока; она не выдаётся для защищённых DOCUMENT и SUPPORT.

Параметр inline управляет Content-Disposition: по умолчанию inline=false возвращает attachment для скачивания; inline=true возвращает inline для просмотра в браузере, например PDF. Для обычных файлов режим передаётся в ссылке на содержимое, а после переноса — и в presigned URL. Пример ссылки для просмотра: /api/file/download/123?inline=true.

Для purpose DOCUMENT и SUPPORT endpoint возвращает расшифрованный файл непосредственно потоком с исходным именем и Content-Type. Параметр redirect для этих purpose игнорируется; presigned URL клиенту не выдаётся. Параметр inline применяется к заголовку потокового ответа. Для просмотра защищённого документа запрос должен содержать JWT или авторизационную cookie.

Для файла с purpose QR авторизация не нужна. Для остальных файлов требуется JWT или действующая подписанная ссылка; для приватных purpose всегда проверяются права доступа.

Query-параметр type выбирает, какую ссылку вернуть:

  • FULL — полный файл
  • PREVIEW — preview файла, если он включён для purpose
Path
idinteger, (int64), >= 1required

Идентификатор файла

Query
typestring

Тип ссылки. По умолчанию FULL

Default:"FULL"
Enum:"FULL""PREVIEW"
redirectboolean

Вернуть HTTP redirect (true) или JSON со ссылкой (false)

Default:true
inlineboolean

Показать файл в браузере (true, Content-Disposition inline) или скачать (false, attachment). Работает для FULL и PREVIEW и не изменяет проверку прав доступа.

Default:false
expiresinteger, (int64)

Срок действия временной ссылки на локальный обычный файл в Unix seconds.

signaturestring

Подпись временной ссылки на локальный обычный файл.

curl -i -X GET \
  'https://felmee.com/api/file/download/{id}?type=FULL&redirect=true&inline=false&expires=0&signature=string'

Responses

Для обычных файлов — временная ссылка при redirect=false; для DOCUMENT и SUPPORT — поток расшифрованного файла.

Body
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

successbooleanrequired

Флаг успешного выполнения запроса

messagestringrequired

Человекочитаемое описание результата

error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(FileStatusData)required

Полезная нагрузка. Может быть объектом, массивом или null.

Response
{ "success": true, "message": "File download link received successfully", "codeError": null, "error_code": null, "data": { "file_id": 7001, "file_name": "avatar.png", "status": "UPLOADED", "url": "https://api.example.com/api/file/content/7001?type=FULL&expires=1893456000&signature=temporary" } }