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

بارگذاری یک فایل

POST 
/api/v1/files/upload

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

دسترسی: کاربر واردشده با حق WRITE، فقط در فضای خودش.

بدنه‌ی درخواست: multipart/form-data. فیلد box (پوشه‌ی مقصد؛ اگر نباشد ساخته می‌شود) باید پیش از بخش file بیاید. در هر درخواست فقط یک فایل.

پاسخ: id، alias، mimeType و isDownloadable. پیوند اشتراک مالک و بندانگشتی هم ساخته می‌شوند.

خطاها: فایل از نظر بدافزار و نوع بررسی می‌شود (مگر برای مشترکی که از بررسی معاف است)؛ فایل آلوده قرنطینه می‌شود. در حال حاضر هر خطایی داخل پردازش، از جمله خطای بررسی، با 400 برمی‌گردد. اگر پذیرش شرایط بارگذاری لازم باشد و سرآیند x-upload-terms معتبر نباشد، پاسخ 403 با code: UPLOAD_TERMS_NOT_ACCEPTED است.

نکته: سرآیند Content-Length الزامی است و بدون آن پاسخ 411 است. حجم اعلام‌شده از سهمیه‌ی مشترک رزرو می‌شود و فایل نمی‌تواند از آن و از سقف هر درخواست (maxRequestSizeInBytes مشترک) بزرگ‌تر باشد؛ بارگذاری بزرگ‌تر قطع و پاک می‌شود و پاسخ 413 است. نام فایل و طول آن هم بررسی می‌شود. این عملیات به مجوز وابسته است (قابلیت upload)؛ در غیر این صورت 402 با code: LICENCE_RESTRICTED.

درخواست​

پاسخ‌ها​