Администратор салона загружает CARD с SERVICE_MANAGE, BLOG с SALON_PAGE, AVATAR с STAFF_MANAGE или SALON_PAGE. Владельцем таких файлов сохраняется владелец его салона. Остальные назначения, включая приватные DOCUMENT и бизнес-документы владельца, администратору не разрешены. Мастер салона не получает права загрузки.
Загружает файл. HTTP 200 возвращается после завершения всех обязательных этапов: проверки, crop/стандартизации, шифрования для защищённых назначений и локальной записи основного файла, оригинала и preview, если они предусмотрены для purpose. На момент успешного ответа файл имеет статус UPLOADED; data.file_id можно сразу использовать при создании услуги, сообщения или привязке другого вложения. Отправка в object storage выполняется фоном. GET /api/file/{id} возвращает ссылку на /api/file/download/{id} в обоих состояниях. Этот endpoint перенаправляет обычный файл к текущему месту хранения. Приватные DOCUMENT и SUPPORT всегда выдаются через API. При ошибке подготовки либо локальной записи возвращается HTTP 500 с error_code=file_upload_failed, без успешного file_id.
JSON-part metadata определяет назначение файла и связанные ограничения по типу, размеру и crop.
Ограничения входных данных:
- файл обязателен и не может быть пустым
- исходное имя файла должно быть непустым и не длиннее 255 символов
- размер файла должен быть больше 0
- количество пикселей изображения ограничено настройкой
file.upload.max-image-pixels(по умолчанию40000000) - для файлов с
content-type, начинающимся наimage/, максимальный размер составляет20 MB - для остальных файлов максимальный размер составляет
100 MB - для
AVATARразрешены толькоimage/png,image/jpeg,image/jpg,image/webp - для
CARDразрешены толькоimage/png,image/jpeg,image/jpg,image/webp - для
REVIEWразрешены изображенияimage/png,image/jpeg,image/jpg,image/webpи видеоvideo/mp4,video/quicktime,video/webm,video/3gpp,video/mpeg - видео
MESSAGEразрешены с MIMEvideo/mp4,video/quicktime,video/webm,video/3gpp,video/mpegи распознаются как видео, в том числе при определении MP4 как QuickTime и WebM как Matroska - для изображений
REVIEWширина и высота должны быть не меньше900, соотношение сторон не больше3:1; для видео размеры изображения не проверяются;cropпередавать нельзя - изображения
REVIEWстандартизируются вimage/webpс короткой стороной900, preview — с короткой стороной200; видео сохраняются без преобразования и без preview - для
BLOGразрешены толькоimage/png,image/jpeg,image/jpg,image/webp - для
CATEGORYразрешены толькоimage/png,image/jpeg,image/jpg,image/webp - для
COMPLAINTразрешены только изображенияimage/png,image/jpeg,image/jpg,image/webp,image/gif,image/bmp,image/heic,image/heif - для
AVATARисходное изображение должно быть не меньше900x900;cropобязателен, должен быть квадратным и не меньше900x900 - для
CARDширина и высота должны быть не меньше900, а соотношение сторон не больше3:1; квадратность не требуется,cropпередавать нельзя - для
BLOGширина и высота должны быть не меньше900, а соотношение сторон не больше3:1; квадратность не требуется,cropпередавать нельзя - для
CATEGORYизображение должно быть квадратным и не меньше300x300;cropпередавать нельзя - для
MESSAGEиVOICEcropпередавать нельзя - изображения
CARDпосле загрузки стандартизируются вimage/webpс короткой стороной900, без увеличения - изображения
AVATARпосле квадратного crop стандартизируются вimage/webpи вписываются в900x900, без увеличения - изображения
BLOGпосле загрузки стандартизируются вimage/webpс короткой стороной900, без увеличения - изображения
CATEGORYпосле загрузки стандартизируются вimage/webpи вписываются в300x300 - изображения
COMPLAINTпосле загрузки стандартизируются вimage/webp; preview создаётся вimage/webpс максимальной стороной900 - preview создаётся только для purpose, где на backend явно задан размер preview
- сейчас preview создаётся для
AVATARвimage/webp, вписанный в150x150 - сейчас preview создаётся для
CARDвimage/webpс короткой стороной200 - сейчас preview создаётся для
MESSAGEimage-файлов вimage/webp, вписанный в900x900 - сейчас preview создаётся для
BLOGвimage/webpс короткой стороной333
CARD используется для карточек мастера, сервиса и салона. REVIEW используется для фотографий и видео отзывов. После успешного ответа upload сразу передайте file_id в media_ids при создании или редактировании отзыва. В сумме допускается до 10 фото и видео. Ранее загруженные изображения CARD также принимаются. BLOG используется для изображений постов. CATEGORY используется для изображений категорий. COMPLAINT используется только как вложение жалобы; прикрепить можно только собственные файлы с этим purpose.
Для первого шага регистрации бизнеса и замены документов отправляйте каждый документ отдельным multipart-запросом: part file — содержимое, part metadata — JSON {"purpose":"DOCUMENT"} с Content-Type application/json. Ответ содержит числовой data.file_id. Успешный ответ возвращается после завершения подготовки и локальной записи. Полученный file_id уже имеет статус UPLOADED. При ошибке upload загрузите файл заново. После этого передайте file_id в files запроса PUT /api/business-registry/registration либо PUT /api/business-registry/registration/documents/reupload. Один upload не изменяет заявку.
Бинарный файл. Имя файла должно быть непустым и не длиннее 255 символов, размер - больше 0 и не более 100 MB.
- https://felmee.comhttps://felmee.com/api/file/upload
- http://localhost:8080http://localhost:8080/api/file/upload
curl -i -X POST \
https://felmee.com/api/file/upload \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: multipart/form-data' \
-F 'file=@avatar.png;type=application/octet-stream' \
-F 'metadata="{\"purpose\":\"AVATAR\",\"crop\":{\"height\":900,\"width\":900,\"x\":0,\"y\":0}}";type=application/json'Файл подготовлен и доступен с локального диска; перенос в object storage выполняется фоном
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
{ "success": true, "message": "File upload successfully", "codeError": null, "error_code": null, "data": { "file_id": 123 } }