جدولة منشور

جدوِل منشوراً للنشر لاحقاً بتوصيل متدرّج ذكي.

الطلب

جدوِل منشوراً للنشر لاحقاً. هذه النقطة مُحسَّنة للتوصيل المجدول — تتحقّق من الوقت المجدول، وتطبّق تدرّجاً ذكياً لتفادي حدود معدل المنصّات، وتُدرج المنشور في قائمة الانتظار لتوصيل موثوق.

الصلاحية المطلوبة: posts:create

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

contentstringRequired

المحتوى النصّي للمنشور. بحد أقصى 63,206 حرفاً.

accountIdsstring[]Required

مصفوفة معرّفات (UUID) للحسابات الاجتماعية المراد النشر إليها.

scheduledAtstringRequired

وقت ISO 8601 لموعد نشر المنشور. يجب أن يكون بعد دقيقة على الأقل من الآن.

mediaUrlsstring[]Optional

مصفوفة روابط وسائط عامة (بحد أقصى 10).

platformCaptionsobjectOptional

تجاوزات محتوى لكل منصة. المفاتيح أسماء منصات بأحرف صغيرة.

tiktokSettingsobjectOptional

إعدادات نشر خاصة بـ TikTok (privacyLevel، disableDuet، إلخ).

youtubeTitlestringOptional

عنوان منفصل لمنشورات YouTube (بحد أقصى 100 حرف).

كيف تعمل الجدولة

التحقّق — يُتحقّق من أن الوقت المجدول بعد دقيقة على الأقل من الآن.
التدرّج — يطبّق eWasl تدرّجاً زمنياً ذكياً لتفادي حدود معدل المنصّات عند جدولة عدّة منشورات قرب الوقت نفسه.
قائمة الانتظار — يُدرَج المنشور للتوصيل في الوقت المحسوب. وتضمن مهمّة cron احتياطية التوصيل حتى لو كانت القائمة غير متاحة مؤقتاً.
النشر — في الوقت المجدول، يُنشر المنشور إلى كل المنصّات المستهدفة.

الاستجابة

يعيد كائن المنشور المجدول. حالة HTTP 201 Created.

idstring

المعرّف الفريد (UUID) للمنشور المُنشأ.

contentstring

المحتوى المُنقّى.

statusstring

دائماً SCHEDULED لهذه النقطة.

platformsstring[]

المنصّات المستهدفة (أحرف صغيرة).

scheduledAtstring

الوقت المجدول النهائي (قد يختلف قليلاً عن مدخلك بسبب التدرّج).

createdAtstring

طابع وقت الإنشاء.

مثال طلب

curl -X POST https://app.ewasl.com/api/v1/posts/schedule \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Happy Monday! Start your week strong.",
    "accountIds": [
      "550e8400-e29b-41d4-a716-446655440000",
      "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
    ],
    "scheduledAt": "2026-12-31T09:00:00Z",
    "platformCaptions": {
      "twitter": "Monday motivation! #MondayVibes",
      "linkedin": "Wishing everyone a productive start to the week. What are you working on today?"
    }
  }'

Response Example

{
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "content": "Happy Monday! Start your week strong.",
    "status": "SCHEDULED",
    "platforms": ["twitter", "linkedin"],
    "mediaUrls": [],
    "scheduledAt": "2026-12-31T09:00:00.000Z",
    "createdAt": "2026-03-01T12:00:00Z"
  }
}