إنشاء منشور
POST /public/v1/postsينشئ منشورًا. وبحسب type يصبح مسودة، أو يذهب إلى التقويم لوقت مستقبلي، أو ينشر فورًا.
والاستدعاء الواحد يستطيع استهداف قنوات كثيرة دفعة واحدة.
وهذا أكبر جسم طلب في API والعملية المقيدة الوحيدة.
إن كنت تفعل ذلك من التطبيق، فراجع إنشاء المنشورات وجدولتها. وهذه العملية
متاحة أيضًا بالأمر sharek posts:create في أداة CLI من شارك،
وبالأداة integrationSchedulePostTool في خادم MCP
من شارك.
جسم الطلب
Section titled “جسم الطلب”| الحقل | مطلوب | الوصف |
|---|---|---|
type |
نعم | واحد من draft أو schedule أو now أو update. |
date |
نعم | وقت النشر بصيغة ISO 8601 وبتوقيت UTC. مطلوب حتى مع draft وnow. وإيجاد الموعد الشاغر التالي يعطيك وقت النشر المتاح التالي على قناة. |
shortLink |
نعم | true لإعادة كتابة الروابط في المحتوى كروابط شارك المختصرة، فتحسب النقرات. |
tags |
نعم | مصفوفة وسوم. قد تكون فارغة، لكن كل مدخل يحتاج value وlabel معًا. |
posts |
نعم | مصفوفة بمدخل واحد على الأقل، واحد لكل قناة. انظر أدناه. |
order |
لا | يقبل ويتجاهل، فلا ترسله. |
inter |
لا | الفترة، بالوحدات نفسها التي يستخدمها التطبيق للمنشورات المتكررة. |
republish |
لا | اضبطه true لنشر منشور سبق نشره مرة أخرى عن قصد. وبدونه يرفض استدعاء schedule أو now يشير أول value[].id فيه إلى منشور سبق نشره. |
creationMethod |
لا | API أو CLI، يسجل على المنشور. وأي شيء آخر يخزن كـ API. |
كل مدخل في posts
Section titled “كل مدخل في posts”| الحقل | مطلوب | الوصف |
|---|---|---|
integration.id |
نعم | القناة التي ينشر إليها، من سرد القنوات. |
value |
نعم | مصفوفة بمدخل واحد على الأقل. فالمدخل الواحد منشور مفرد؛ وعدة مدخلات تصنع سلسلة نقاش، كل واحد يرد على سابقه. |
value[].content |
نعم | نص المنشور. ويجوز أن يكون نصًا فارغًا فقط إن حمل ذلك المدخل صورة واحدة على الأقل. |
value[].image |
نعم | مصفوفة وسائط. ومصفوفة فارغة حين لا توجد. |
value[].delay |
لا | الدقائق التي تنتظر قبل هذا المدخل في سلسلة النقاش. |
value[].id |
لا | معرف منشور أو رد قائم، لتحديثه في مكانه بدل إنشاء جديد. |
settings |
لا | خيارات المزود. وإغفاله يساوي إرسال {}، وهو ما يرفضه المزود الذي له خيارات مطلوبة. |
group |
لا | قيمة group لمنشور قائم يحل هذا المدخل محله. فيزال المنشور القديم، ويأخذ الجديد group خاصًا به. |
لا يوجد تاريخ لكل قناة: فأي date داخل مدخل من مدخلات posts يتجاهل، وdate في المستوى
الأعلى ينطبق على كل قنوات الاستدعاء. وللنشر في أوقات مختلفة، اجعل لكل وقت استدعاءً مستقلًا.
كل مدخل في image
Section titled “كل مدخل في image”الوسائط يجب أن ترفع أولًا. خذ id وpath مباشرة من
رفع ملف أو
الرفع من عنوان. ولملف موجود أصلًا في مكتبة الوسائط،
يعيد سرد الوسائط الزوج نفسه.
| الحقل | مطلوب | الوصف |
|---|---|---|
id |
نعم | معرف الوسائط الذي يعيده الرفع. |
path |
نعم | عنوان الوسائط الذي يعيده الرفع. ويجب أن ينتهي بـ .png أو .jpg أو .jpeg أو .gif أو .webp أو .mp4. |
alt |
لا | النص البديل. |
thumbnail |
لا | عنوان الصورة المصغرة. |
لا ترسل __type
Section titled “لا ترسل __type”مميز المزود داخل settings يملؤه شارك من القناة التي سميتها، وأي قيمة ترسلها تستبدل.
أرسل خيارات المزود الحقيقية فقط:
"settings": { "title": "My video", "type": "public" }وما يقبله كل مزود موجود في صفحة لكل قناة، تصل إليها من القنوات التي يوفرها شارك؛ وإعدادات X مثال أول جيد. ولقراءة المخطط الحي لقناة بعينها بدلًا من ذلك، استدع إعدادات القناة.
جدولة منشور نصي واحد:
curl -X POST https://dash.sharek.app/api/public/v1/posts \ -H "Authorization: your-api-key" \ -H "Content-Type: application/json" \ -d '{ "type": "schedule", "date": "2026-09-01T10:00:00.000Z", "shortLink": false, "tags": [], "posts": [ { "integration": { "id": "channel-id" }, "value": [ { "content": "Hello from the Sharek API", "image": [] } ], "settings": {} } ] }'جدولة منشور بصورة:
curl -X POST https://dash.sharek.app/api/public/v1/posts \ -H "Authorization: your-api-key" \ -H "Content-Type: application/json" \ -d '{ "type": "schedule", "date": "2026-09-01T10:00:00.000Z", "shortLink": false, "tags": [], "posts": [ { "integration": { "id": "channel-id" }, "value": [ { "content": "Our new release is out", "image": [ { "id": "media-id", "path": "https://media.example.com/launch.png" } ] } ], "settings": { "post_type": "post" } } ] }'جدولة سلسلة من جزأين. المدخلات الزائدة في value تصير ردودًا:
curl -X POST https://dash.sharek.app/api/public/v1/posts \ -H "Authorization: your-api-key" \ -H "Content-Type: application/json" \ -d '{ "type": "schedule", "date": "2026-09-01T10:00:00.000Z", "shortLink": false, "tags": [], "posts": [ { "integration": { "id": "channel-id" }, "value": [ { "content": "First post in the thread", "image": [] }, { "content": "The reply that follows it", "image": [] } ], "settings": {} } ] }'الاستجابة
Section titled “الاستجابة”مدخل واحد لكل قناة في الطلب:
[ { "postId": "post-id", "integration": "channel-id" }]احتفظ بـ postId. فهو ما تأخذه تغيير الحالة
وتحديث الإعدادات والحذف
وتحليلات المنشور جميعًا.
الأنواع الأربعة
Section titled “الأنواع الأربعة”type |
ما الذي يحدث |
|---|---|
draft |
يحفظ في التقويم، ولا ينشر من تلقاء نفسه أبدًا. جدوِله لاحقًا بـ تغيير الحالة. |
schedule |
يوضع في قائمة الانتظار لـ date. |
now |
ينشر فورًا. وdate ما زال مطلوبًا. |
update |
يحفظ التعديلات على المنشورات التي تسميها value[].id في مكانها ويبقي حالتها. ولا يبدأ تشغيل النشر بنفسه. أما بلا تلك المعرفات فينشئ منشورات مجدولة جديدة، ينشرها فحص شارك الذي يجري كل ساعة بحثًا عن المنشورات الفائتة بعد مرور date (ما لم يكن date أقدم من يومين)، لذا أرسل المعرفات دائمًا. |
وقبول الاستدعاء ليس كنشره. فحين يفشل منشور عند نشره، يرفع شارك إشعارًا تعيده
سرد الإشعارات، وقد تعرض سرد المنشورات
سبب المنصة في error.
التحقق
Section titled “التحقق”يجري شارك الفحوص نفسها التي يجريها المحرر، ويعيد أول إخفاق بـ 400:
{ "statusCode": 400, "provider": "youtube", "name": "My channel", "message": "post is too long, please fix it"}وprovider وname يخبرانك أي قناة رفضته، وهو ما يهم حين يستهدف استدعاء واحد عدة قنوات.
والمسودات تفحص فحصًا أقل صرامة، لكن الأقل صرامة لا يعني بلا فحص. فالمسودة ما زالت
تحتاج محتوى أو صورة، وما زالت تحتاج كائن settings صالحًا لمزودها. وقد تم التحقق من ذلك
مقابل الإنتاج في 2026-08-24: إنشاء draft لقناة Instagram بـ "settings": {} يرفض بـ
{ "statusCode": 400, "message": [ "posts.0.settings.post_type should not be null or undefined", "posts.0.settings.post_type must be one of the following values: post, story" ], "error": "Bad Request"}وما تتخطاه المسودة فعلًا هو طبقة وقت النشر: فقواعد الوسائط لكل قناة وحد طولها لا تفحص إلا
حين يكون type هو schedule أو now أو update، لذا تحفظ المسودة التي تخالفها رغم ذلك.
| الاستجابة | المعنى |
|---|---|
400 {"statusCode": 400, "provider": ..., "message": ...} |
رفضت قناة المنشور. والرسالة هي النص نفسه الذي يعرضه المحرر. |
400 {"message": ["..."], "error": "Bad Request"} |
الجسم نفسه مشوه: حقل مطلوب ناقص، أو تاريخ غير صالح، أو مصفوفة posts فارغة. |
400 {"statusCode": 400, "message": "Integration with id ... not found", "error": "Bad Request"} |
معرف قناة في الطلب لا يخص مؤسستك. ولاحظ أن message هنا نص عادي، لا المصفوفة التي يستخدمها شكل التحقق من الحقول. |
402 |
بلغ حد من حدود الخطة، وغالبًا المنشورات في الشهر. وurl في الجسم يشير إلى موضع حل المشكلة. |
429 |
أكثر من 100 استدعاء إنشاء في الساعة الماضية. |