إلغاء منشور مجدول

يلغي منشورًا لا يزال ينتظر النشر. ينتقل المنشور إلى ARCHIVED وتستبعده عملية النشر. يمكن إلغاء المسودات بالطريقة نفسها؛ أما المنشورات التي نُشرت بالفعل فلا يمكن إلغاؤها.

حالة استخدام: عميل يسحب حملة في اللحظة الأخيرة. يعرض تقويمك منشورًا مجدولًا، ثم يغيّر العميل رأيه، فتلغيه من واجهتك. خذ id الخاص بالمنشور مباشرةً من قائمة منشورات العلامة التجارية واستدعِ نقطة النهاية هذه؛ ينتقل الصف إلى ARCHIVED ويختفي من نتائج التصفية باستخدام {"status":["SCHEDULED"]} عند القراءة التالية.

حالة استخدام: إلغاء المنشورات المعلّقة قبل قطع اتصال قناة. قطع الاتصال لا يلغي المنشورات الموجودة بالفعل في قائمة الانتظار لذلك الاتصال — بل تفشل عند حلول وقت النشر مع SY95045. ألغِ المنشورات المجدولة أولًا، ثم اقطع الاتصال، ولن يرى العميل أي حالات فشل على الإطلاق.

ملاحظات.

• يجب تغليف جسم الطلب داخل كائن input.
• تحقّق من success، وليس من حالة HTTP. إذا كان المنشور قد نُشر بالفعل أو أُلغي بالفعل، يُرجع الاستدعاء HTTP 200 مع success: false.
• هذه ليست عملية حذف. لا يُزال أي شيء من أي منصة. يظل المنشور الذي نُشر بالفعل متاحًا، ويكتفي هذا الاستدعاء بإرجاع success: false له. لا توجد نقطة نهاية تلغي نشر منشور على وسائل التواصل الاجتماعي؛ بل يُزال من المنصة نفسها.
• يشمل الإلغاء جميع قنوات المنشور أو لا يُنفّذ على أي منها. لا توجد طريقة لإلغاء منشور مجدول على منصة واحدة مع السماح بنشره على منصة أخرى؛ أنشئ منشورات منفصلة إذا كنت بحاجة إلى ذلك.
• يظل المنشور قابلًا للقراءة بعد ذلك باستخدام GET /social/posts/{postId}، وتكون قيمة post.status هي ARCHIVED.

عملية كتابة: لم تُنفّذ على الحساب الفعلي. أُنشئ الطلب والاستجابة المعروضان استنادًا إلى مخطط API.