Media
تحميل ملفات وسائط كبيرة
لتحميل الملفات الأكبر من 10 ميجابايت، احصل على عنوان URL موقّع مسبقًا لتحميل ملف
GET
لتحميل الملفات الأكبر من 10 ميجابايت، احصل على عنوان URL موقّع مسبقًا لتحميل ملف.
يرجى التأكد من أن

- الحد الأقصى لحجم تحميل الملف 5 جيجابايت.
- عنوان URL الموقّع مسبقًا للتحميل صالح لمدة 30 دقيقة بعد إنشائه.
- عنوان URL للوصول متاح لمدة 30 يومًا بعد التحميل. جميع المنشورات المُنشورة لا تتأثر على شبكات التواصل الاجتماعي. المنشورات المجدولة بعد ذلك الإطار الزمني ستؤدي إلى أخطاء عند وقت النشر.
معلمات الترويسة
معلمات الاستعلام
إذا لم يكن contentType موجودًا، فإن اسم ملف كامل مع الامتداد مطلوب.اسم الملف المراد تحميله. يجب أن يتضمن امتدادًا مثل .png، .jpg، .mov، .mp4، إلخ.
نوع المحتوى (content-type) للوسائط التي يتم تحميلها. الصيغ الصالحة تشمل:
mp4 وmov وpng وjpg أو jpeg.على سبيل المثال، إذا كان الملف ملف Quicktime .mov، فيجب أن يكون contentType هو mov.إذا لم يكن موجودًا، سيتم استخدام application/octet-stream.تفاصيل الاستجابة
accessUrlهو عنوان URL للوصول إلى ملف الوسائط بعد التحميل.contentTypeهو نوع المحتوى المُعيَّن للوسائط التي يتم تحميلها. استخدمه في ترويسة Content-Type عند تحميل الوسائط.uploadUrlهو عنوان URL المُستخدم لـ PUT ملف الوسائط. يرجى الاطلاع أدناه.
أمثلة إضافية لنقطة النهاية
عملية تحميل الملفات الأكبر:- احصل على
uploadURLوaccessURLعبر نقطة النهاية/media/uploadUrl. يرجى الاطلاع أعلاه. - حمّل الملف عبر PUT مع تعيين Content-Type إلى
contentTypeالمُعاد. - حمّل الوسائط باستخدام
--upload-fileمع ملف وسائط وuploadUrl. - عند التحميل الناجح، ستُعاد استجابة
200. - بعد تحميل ملف الوسائط، POST إلى نقطة النهاية
/postمعaccessUrlفي معلمة الجسمmediaUrls. - يمكن التحميل إلى عنوان URL الموقّع مسبقًا مرة واحدة فقط. إذا أرسلت ملفًا سيئًا، يجب عليك إنشاء عنوان URL جديد للتحميل. لن تحدث استجابة خطأ إذا لم يتم تحميل الملف بنجاح. راجع أدناه للتحقق من وجود عنوان URL.
contentType المُعيَّن عند إنشاء uploadUrl يطابق Content-Type ونوع الملف عند PUT الملف.
على سبيل المثال، إذا عيّنت contentType على “image/png” عند إنشاء uploadUrl، فتأكد من تعيين Content-Type: image/png وأن الملف المُحمَّل ينتهي بـ .png.
عند التحميل الناجح، ستُعاد استجابة 200.
مثال على تحميل ملف ثنائي في Node.js
هنا مثال على تحميل ملف وسائط ثنائي باستخدام Node مع JavaScript:مثال على تحميل ملف ثنائي في Postman
يمكنك أيضًا استخدام Postman لتحميل الملف الثنائي إلىuploadUrl.
في Postman:
- اختر طريقة HTTP
PUT. - الصق
uploadUrlفي حقل url. لاحظ أن عنوان URL سينتهي بعد ساعة ولا يمكن استخدامه إلا مرة واحدة. إذا قمت باستدعاء وفشل، يجب عليك إعادة إنشاءuploadUrl. - في Headers عيّن
Content-Typeليكون نوع المحتوى المُعاد في نقطة نهاية /uploadUrl. على سبيل المثال:Content-Type: image/png. - اختر Body -> binary واختر الملف المراد تحميله.
- اضغط Send.
- مهم: لن تحدث استجابة إرجاع، لذا يجب عليك التحقق مما إذا كان التحميل قد نجح بفتح
accessUrlالمُعاد من نقطة نهاية /uploadUrl في متصفح. يمكنك أيضًا استخدام نقطة نهاية التحقق من URL.

