Администратор может читать собственные доступные файлы и делегированные 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
- https://felmee.comhttps://felmee.com/api/file/download/{id}
- http://localhost:8080http://localhost:8080/api/file/download/{id}
curl -i -X GET \
'https://felmee.com/api/file/download/{id}?type=FULL&redirect=true&inline=false&expires=0&signature=string'Для обычных файлов — временная ссылка при redirect=false; для DOCUMENT и SUPPORT — поток расшифрованного файла.
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
{ "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" } }