الانتقال إلى المحتوى الرئيسي
GET
لتحميل الملفات الأكبر من 10 ميجابايت، احصل على عنوان URL موقّع مسبقًا لتحميل ملف.
  • الحد الأقصى لحجم تحميل الملف 5 جيجابايت.
  • عنوان URL الموقّع مسبقًا للتحميل صالح لمدة 30 دقيقة بعد إنشائه.
  • عنوان URL للوصول متاح لمدة 30 يومًا بعد التحميل. جميع المنشورات المُنشورة لا تتأثر على شبكات التواصل الاجتماعي. المنشورات المجدولة بعد ذلك الإطار الزمني ستؤدي إلى أخطاء عند وقت النشر.
إذا كانت وسائطك متاحة بالفعل عبر عنوان URL خارجي، مثل حاوية S3، يمكنك تخطي تحميل الملفات إلى Ayrshare. ما عليك سوى POST إلى نقطة النهاية /post مع عنوان URL المتاح خارجيًا في معلمة الجسم mediaURLs، وسيتم تحميل ملفك تلقائيًا.

معلمات الترويسة

معلمات الاستعلام

fileName
string
إذا لم يكن contentType موجودًا، فإن اسم ملف كامل مع الامتداد مطلوب.اسم الملف المراد تحميله. يجب أن يتضمن امتدادًا مثل .png، .jpg، .mov، .mp4، إلخ.
contentType
string
نوع المحتوى (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:
  1. اختر طريقة HTTP PUT.
  2. الصق uploadUrl في حقل url. لاحظ أن عنوان URL سينتهي بعد ساعة ولا يمكن استخدامه إلا مرة واحدة. إذا قمت باستدعاء وفشل، يجب عليك إعادة إنشاء uploadUrl.
  3. في Headers عيّن Content-Type ليكون نوع المحتوى المُعاد في نقطة نهاية /uploadUrl. على سبيل المثال: Content-Type: image/png.
  4. اختر Body -> binary واختر الملف المراد تحميله.
  5. اضغط Send.
  6. مهم: لن تحدث استجابة إرجاع، لذا يجب عليك التحقق مما إذا كان التحميل قد نجح بفتح accessUrl المُعاد من نقطة نهاية /uploadUrl في متصفح. يمكنك أيضًا استخدام نقطة نهاية التحقق من URL.
Postman Binary Upload

ملف JSON نموذجي لـ Postman