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

نشانی امضاشده برای دانلود از پیوند رمزدار

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

همان بررسی‌های دانلود از پیوند رمزدار را انجام می‌دهد و یک نشانی امضاشده برای دانلود برمی‌گرداند. نشانی امضاشده را با GET /api/v1/SharingService/FileDownload/Download/{fileId}/Signed باز کنید. برنامه‌ی وب برای دانلود از صفحه‌ی اشتراک از همین مسیر استفاده می‌کند.

دسترسی: بدون ورود؛ مجوز دسترسی رمز پیوند است. رمز پیوند را در سرآیند X-Share-Password بفرستید، به صورت base64 از متن UTF-8 رمز. رمز هرگز در نشانی امضاشده نمی‌آید و با تغییر رمز پیوند، نشانی‌های ساخته‌شده از کار می‌افتند.

پاسخ: { url, expires }. url نشانی امضاشده‌ی کوتاه‌مدت (به‌طور پیش‌فرض ۱۰ دقیقه) نسبت به /api/v1/SharingService/FileDownload/ است و expires زمان انقضای آن به ثانیه‌ی یونیکس. مرورگر خودش این نشانی را باز می‌کند، پس فایل با دانلود خود مرورگر و بدون سقف حجم ذخیره می‌شود. پاسخ هرگز cache نمی‌شود (Cache-Control: no-store).

گزارش دانلود: دانلود همین‌جا، با کاربر واقعی، در گزارش دانلودهای پیوند ثبت می‌شود؛ باز کردن نشانی امضاشده و ادامه‌ی دانلود چیزی به گزارش اضافه نمی‌کند.

خطاها: 401 وقتی سرآیند رمز نباشد، خالی باشد یا base64 معتبر نباشد؛ 404 وقتی رمز اشتباه باشد. 404 وقتی پیوند فعال و منقضی‌نشده‌ای برای این فایل و stamp نباشد؛ 404 با متن Physical File Not Found! وقتی فایل روی دیسک نباشد.

نکته: stamp باید شماره‌ی همان پیوند باشد؛ 0 یا مقدار منفی پذیرفته نمی‌شود و پاسخ 404 است. name نامی است که فایل با آن ذخیره می‌شود؛ نویسه‌های کنترلی و / حذف و نام به ۲۰۰ نویسه کوتاه می‌شود و پسوند فایل اصلی همیشه حفظ می‌شود.

درخواست​

پاسخ‌ها​

OK