دانلود از پوشه‌ی اشتراکی ویژه‌ی کاربران
GET/api/v1/SharingService/FileDownload/Download/:fileId/Stamp/:stamp/Path/:path/MembersOnly
یک فایل را از درون پوشه‌ای دانلود می‌کند که با پیوندِ بدون رمزِ ویژه‌ی کاربران واردشده به اشتراک گذاشته شده.
دسترسی: هر کاربر واردشده با سرآیند Authorization.
مسیر فایل: path مسیر فایل نسبت به ریشه‌ی پوشه‌ی اشتراکی است (مثلاً reports/2026/a.pdf)، کدشده با base64 امن برای URL و بدون = پایانی. مسیری که با / شروع شود، بخش . یا .. داشته باشد یا از ریشه‌ی پوشه بیرون برود پذیرفته نمی‌شود و پاسخ 404 است.
پاسخ: محتوای فایل به صورت پیوست. ایمیل دانلودکننده و مسیر نسبی فایل در گزارش دانلود ثبت می‌شود.
خطاها: 401 بدون توکن. 404 وقتی پیوند فعالِ مطابقی نباشد یا مسیر نامعتبر باشد.
نکته: stamp باید شماره‌ی همان پیوند باشد؛ 0 یا مقدار منفی پذیرفته نمی‌شود و پاسخ 404 است. برای پوشه‌های اشتراکی، مسیر بدون ورود و بدون رمز وجود ندارد؛ پیوند عمومیِ پوشه همیشه رمز دارد.
پیوند پوشه: فایل درون مسیر فقط وقتی دانلود می‌شود که پیوند برای یک پوشه ساخته شده باشد و اجازه‌ی دانلود بدهد؛ برای پیوند یک فایل یا پوشه‌ای که فقط بارگذاری می‌پذیرد پاسخ 404 است.
درخواست
پاسخ‌ها
- 200
OK