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

دانلود فایل از پوشه‌ی اشتراکی رمزدار

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

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

دسترسی: بدون ورود؛ مجوز دسترسی رمز پیوند است. رمز پیوند را در سرآیند X-Share-Password بفرستید، به صورت base64 از متن UTF-8 رمز (نه خود رمز).

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

پاسخ: محتوای فایل به صورت پیوست. مسیر نسبی فایل در گزارش دانلود ثبت می‌شود.

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

نکته: stamp باید شماره‌ی همان پیوند باشد؛ 0 یا مقدار منفی پذیرفته نمی‌شود و پاسخ 404 است.

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

درخواست​

پاسخ‌ها​

OK