تخطَّ إلى المحتوى

حذف مجموعة منشورات

DELETE /public/v1/posts/group/{group}

يحذف كل منشور يتشارك معرف مجموعة. وهو الحذف نفسه الذي يؤديه حذف منشور، مخاطبًا بالمجموعة مباشرة بدل معرف منشور من أعضائها.

استخدمه حين تعرف المجموعة أصلًا، من سرد المنشورات مثلًا، وتريد تخطي البحث.

وهذه العملية لا يقابلها أمر في أداة CLI من شارك، ولا أداة في خادم MCP من شارك.

المعامل مطلوب الوصف
group نعم قيمة group على أي منشور في المجموعة.
Terminal window
curl -X DELETE https://dash.sharek.app/api/public/v1/posts/group/group-id \
-H "Authorization: your-api-key"
{ "id": "post-id" }

وid هو معرف المنشور الأول في المجموعة المحذوفة. أما 200 مع {"error": true} فيعني أن تلك المجموعة لم تطابق أي منشور.

  • معرف مجموعة لا يطابق شيئًا يجيب أيضًا 200، مع {"error": true}، وقد تم التحقق من ذلك مقابل الإنتاج في 2026-08-24. وحذف مجموعة سبق أن حذفتها يجيب 200 مع id الخاص بها مرة أخرى. وهذه العملية آمنة للاستدعاء أكثر من مرة وآمنة في مسارات التنظيف، بخلاف حذف منشور: إذ يعيد حذف معرف منشور مجهول هناك 404. ففضل هذه في أي شيء يعيد المحاولة.
  • لمنشور كل قناة مجموعته الخاصة، ومن ثم فاستدعاء إنشاء منشور واحد عبر ثلاث قنوات ينتج ثلاث مجموعات. والتراجع عن ذلك الاستدعاء يحتاج حذفًا واحدًا لكل قناة.