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

دانلود از پوشه‌ی رمزدار ویژه‌ی کاربران

GET 
/api/v1/SharingService/FileDownload/Download/:fileId/Stamp/:stamp/Password/Path/:path/MembersOnly

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

دسترسی: هر کاربر واردشده با سرآیند Authorization، به‌علاوه‌ی رمز پیوند. رمز پیوند را در سرآیند X-Share-Password بفرستید، به صورت base64 از متن UTF-8 رمز (نه خود رمز).

مسیر فایل: path مسیر فایل نسبت به ریشه‌ی پوشه‌ی اشتراکی است (مثلاً reports/2026/a.pdf)، کدشده با base64 امن برای URL و بدون = پایانی. مسیری که با / شروع شود، بخش . یا .. داشته باشد یا از ریشه‌ی پوشه بیرون برود پذیرفته نمی‌شود و پاسخ 404 است.

پاسخ: محتوای فایل به صورت پیوست.

خطاها: 401 بدون توکن. 404 وقتی رمز اشتباه باشد، پیوندی نباشد یا مسیر نامعتبر باشد. اگر سرآیند رمز خالی باشد یا base64 معتبر نباشد هم پاسخ 401 است.

نکته: stamp باید شماره‌ی همان پیوند باشد؛ 0 یا مقدار منفی پذیرفته نمی‌شود و پاسخ 404 است. در حال حاضر ایمیل دانلودکننده در گزارش ثبت نمی‌شود و دانلود با برچسب PasswordProtected ثبت می‌شود.

پیوند پوشه: فایل درون مسیر فقط وقتی دانلود می‌شود که پیوند برای یک پوشه ساخته شده باشد و اجازه‌ی دانلود بدهد؛ برای پیوند یک فایل یا پوشه‌ای که فقط بارگذاری می‌پذیرد پاسخ 404 است.

درخواست​

پاسخ‌ها​

OK