الانتقال إلى المحتوى الرئيسي
POST
تتيح لك نقطة النهاية هذه تحميل ملف — صورة أو فيديو صغير — لتضمينه في منشورك. تُرجع هذه النقطة عنوان URL للصورة الذي يمكن استخدامه في نقطة النهاية ‎/post. يمكنك تمرير الملف إما كـ multipart form data عبر معامل نموذج، أو كـ ملف مشفَّر بـ Base64 عبر معامل النص. ملاحظات مهمة حول تحميل الوسائط:
  1. لأفضل أداء، نوصي بـ
    • استضافة ملفات الوسائط على خادمك الخاص (مثل AWS S3).
    • تمرير عنوان URL للوسائط مباشرةً في معامل mediaUrls في نقطة النهاية /post.
    • هذا النهج أسرع من تحميل الملفات عبر نقطة النهاية هذه.
  2. مدة الاحتفاظ بملفات الوسائط
    • تُخزَّن الملفات المحمَّلة لمدة 90 يومًا.
    • بعد 90 يومًا:
      • لا تتأثر المنشورات المنشورة بالفعل على الشبكات الاجتماعية.
      • ستفشل المنشورات المجدولة في النشر إذا كانت تشير إلى وسائط منتهية الصلاحية.
  3. حدود حجم الملف
إذا كانت وسائطك متاحة عبر عنوان URL خارجي، مثل حزمة S3، يمكنك تخطي تحميل الملفات إلى Ayrshare. أرسل طلب POST إلى نقطة النهاية /post مع عنوان URL الخارجي القابل للوصول في معامل النص mediaURLs، وسيُحمَّل ملفك تلقائيًا.

معاملات الرأس (Header)

Content-Type
string
مطلوب
استخدم multipart/form-data عند إرسال بيانات نموذج multipart form-data — انظر أدناه. وإلا، أرسل النوع القياسي application/json.

معاملات النص (Body)

file
string or object
مطلوب
الحد الأقصى لحجم الملف 30 ميجابايت.نوصي بالإرسال ككائن multipart form-data بدلًا من تشفير Base64.
fileName
string
اسم الملف المراد تحميله.
description
string
وصف للملف.

الإرسال كـ Multipart Form-Data

أرسل ملف الوسائط ككائن multipart form-data. تأكّد من تحديد Content-Type كما ذُكر أعلاه.

الإرسال كـ Base64

أرسل ملف الوسائط كسلسلة مشفَّرة بـ Base64 كسلسلة Data URI. يجب أن تبدأ السلسلة بـ data:content/type;base64 مثال على التشفير مع تنسيق الإخراج Data URI: ملاحظة: نقطة النهاية ‎/post تقبل ملفات أكبر عبر عنوان URL خارجي باستخدام معامل mediaUrls.