تحديث إعدادات المنشور
PUT /public/v1/posts/{id}/settingsيغير خيارات المزود على منشور قائم: عنوان على YouTube، أو flair على Reddit، أو لوحة على Pinterest. ولا يمس نص المنشور ولا وسائطه ولا قناته ولا تاريخه.
وهذه العملية متاحة أيضًا بالأداة postSettingsTool في خادم
MCP من شارك، ولا يقابلها أمر في أداة CLI.
معاملات المسار
Section titled “معاملات المسار”| المعامل | مطلوب | الوصف |
|---|---|---|
id |
نعم | معرف المنشور الرئيسي، لا أحد ردود سلسلته. |
جسم الطلب
Section titled “جسم الطلب”| الحقل | مطلوب | الوصف |
|---|---|---|
settings |
نعم | كائن. والمفاتيح التي ترسلها تدمج فوق إعدادات المنشور القائمة. |
وما يقبله كل مزود موثق في صفحة لكل قناة، مدرجة تحت القنوات التي يوفرها شارك. وللمخطط الحي لقناة بعينها، استدع إعدادات القناة.
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" } }'الاستجابة
Section titled “الاستجابة”{ "postId": "post-id", "publishDate": "2026-09-01T10:00:00" }ولاحظ أن publishDate يعود هنا بلا لاحقة منطقة زمنية وبلا أجزاء من الثانية، خلافًا
للأختام الزمنية الكاملة التي تعيدها كل عملية أخرى. وهو مع ذلك بتوقيت UTC.
متى يرفض هذا
Section titled “متى يرفض هذا”يجب أن يكون المنشور مما لم ينشر بعد، وأن يكون المنشور الرئيسي.
| الاستجابة | المعنى |
|---|---|
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 |
المنشور ما زال في قائمة الانتظار لكن وقته في الماضي، فلم يعد قابلًا للتعديل. |
ملاحظات
Section titled “ملاحظات”- الإعدادات تدمج لا تستبدل. أرسل المفاتيح التي تريد تغييرها فقط ويحفظ ما تبقى من إعدادات المنشور. ولا سبيل إلى إزالة مفتاح بهذه الطريقة، بل إلى الكتابة فوقه فقط.
- لا تضمن
__type. فشارك يضبطه دائمًا من قناة المنشور نفسها ويكتب فوق ما ترسله. - في المنشور المجدول تمر الإعدادات المدموجة بفحوص الإعدادات والوسائط والطول نفسها التي
يجريها الإنشاء، فالتغيير الذي يخالف قواعد المزود يرفض لا يحفظ. أما في المسودة فلا يجري
إلا فحص المحتوى الفارغ. والرفض هنا يأتي بالشكل
{"statusCode": 400, "message": "<channel name>: <reason>", "error": "Bad Request"}، لا بشكلproviderوnameالذي يعيده الإنشاء. والمحتوى والوسائط ينقلان دون مساس، ما يعني أن منشورًا كان نصه فارغًا أصلًا وبلا صورة يرفض هنا أيضًا.