الملفات

رفع ملف

POST/v1/files/uploadsscope: files.write

الخطوة 1: اطلب رفعاً جديداً بالاسم والحجم والنوع. نُرجع رابط PUT موقّعاً صالحاً لساعة.

الخطوة 2: ارفع محتوى الملف إلى الرابط مباشرة، ثم استدعِ POST /v1/files/{id}/complete.

للملفات الأكبر من 100MB نُرجع رفعاً مجزّأً (multipart): ارفع كل جزء وأرسل قائمة partNumber و etag عند الإكمال.

المعاملات

namestringrequired

اسم الملف.

sizeintegerrequired

الحجم بالبايت.

mimestring

نوع المحتوى.

folderIdstring

المجلد الهدف (الافتراضي الجذر).

conflictrename | replace | fail

ماذا يحدث إن وُجد ملف بنفس الاسم. replace ينشئ نسخة جديدة.

الأخطاء

400 file_too_large400 quota_exceeded409 name_conflict