پرش به مطلب اصلی

بارگذاری در پوشه‌ی اشتراکی رمزدار

POST 
/api/v1/public-files/upload/folderId/:folderId/stamp/:stamp/password

به گیرنده‌ی ناشناس اجازه می‌دهد فایلی را در پوشه‌ای که با پیوند اشتراک عمومی و رمز به اشتراک گذاشته شده بارگذاری کند.

دسترسی: ناشناس. رمز پیوند در سرآیند x-share-password فرستاده می‌شود، نه در نشانی. اعتبار پیوند در هر درخواست دوباره بررسی می‌شود.

بدنه‌ی درخواست: multipart/form-data با یک بخش file؛ فیلدهای اختیاری description (حداکثر ۵۱۲ نویسه)، tags (حداکثر ۲۵۶ نویسه) و fieldValues (پاسخ به فیلدهای سفارشی‌ای که پوشه از فرستنده می‌خواهد؛ اگر فیلد الزامی بی‌پاسخ بماند درخواست رد می‌شود).

محدودیت‌ها: سقف اندازه‌ی هر فایل maxRequestSizeInBytes مالک است و اگر تنظیم نشده باشد سقف پیش‌فرض سرور (در نبود آن ۲ گیگابایت)؛ بیشتر از آن 413. پسوند فایل باید در فهرست مجاز سرور و در allowedUploadTypes پیوند باشد، وگرنه 415. محتوای فایل با نوع آن مقایسه و از نظر بدافزار بررسی می‌شود؛ فایل آلوده قرنطینه می‌شود و پاسخ 400 است. حجم درخواست با فضای آزاد مالک هم سنجیده می‌شود.

خطاها: 411 اگر سرآیند Content-Length نباشد؛ 404 اگر پیوند معتبر نباشد یا پوشه پیدا نشود؛ 403 اگر پیوند اجازه‌ی بارگذاری ندهد، پوشه رمزگذاری‌شده باشد یا path بیرون از پوشه‌ی اشتراکی باشد؛ 409 با پیام This share has reached its file limit وقتی سقف تعداد فایل پیوند پر شده باشد.

نکته: این عملیات به مجوز وابسته است (قابلیت share.upload)؛ در غیر این صورت 402 با code: LICENCE_RESTRICTED.

درخواست​

پاسخ‌ها​