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

تحديث إعدادات المنشور

PUT /public/v1/posts/{id}/settings

يغير خيارات المزود على منشور قائم: عنوان على YouTube، أو flair على Reddit، أو لوحة على Pinterest. ولا يمس نص المنشور ولا وسائطه ولا قناته ولا تاريخه.

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

المعامل مطلوب الوصف
id نعم معرف المنشور الرئيسي، لا أحد ردود سلسلته.
الحقل مطلوب الوصف
settings نعم كائن. والمفاتيح التي ترسلها تدمج فوق إعدادات المنشور القائمة.

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

Terminal window
curl -X PUT https://dash.sharek.app/api/public/v1/posts/post-id/settings \
-H "Authorization: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"settings": {
"title": "A better title",
"type": "public"
}
}'
{ "postId": "post-id", "publishDate": "2026-09-01T10:00:00" }

ولاحظ أن publishDate يعود هنا بلا لاحقة منطقة زمنية وبلا أجزاء من الثانية، خلافًا للأختام الزمنية الكاملة التي تعيدها كل عملية أخرى. وهو مع ذلك بتوقيت UTC.

يجب أن يكون المنشور مما لم ينشر بعد، وأن يكون المنشور الرئيسي.

الاستجابة المعنى
404 {"statusCode": 404, "message": "Post not found", "error": "Not Found"} لا منشور بهذا المعرف في مؤسستك، بما في ذلك منشور سبق أن حذفته.
400 This id belongs to a comment, pass the id of the main post استخدمت معرف رد. استخدم المعرف الذي أعاده استدعاء الإنشاء لتلك القناة.
400 Only scheduled posts that were not published yet (or drafts) can be updated المنشور تم نشره بالفعل أو في حالة خطأ.
400 The publish time of this post already passed, it cannot be updated المنشور ما زال في قائمة الانتظار لكن وقته في الماضي، فلم يعد قابلًا للتعديل.
  • الإعدادات تدمج لا تستبدل. أرسل المفاتيح التي تريد تغييرها فقط ويحفظ ما تبقى من إعدادات المنشور. ولا سبيل إلى إزالة مفتاح بهذه الطريقة، بل إلى الكتابة فوقه فقط.
  • لا تضمن __type. فشارك يضبطه دائمًا من قناة المنشور نفسها ويكتب فوق ما ترسله.
  • في المنشور المجدول تمر الإعدادات المدموجة بفحوص الإعدادات والوسائط والطول نفسها التي يجريها الإنشاء، فالتغيير الذي يخالف قواعد المزود يرفض لا يحفظ. أما في المسودة فلا يجري إلا فحص المحتوى الفارغ. والرفض هنا يأتي بالشكل {"statusCode": 400, "message": "<channel name>: <reason>", "error": "Bad Request"}، لا بشكل provider وname الذي يعيده الإنشاء. والمحتوى والوسائط ينقلان دون مساس، ما يعني أن منشورًا كان نصه فارغًا أصلًا وبلا صورة يرفض هنا أيضًا.