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

إنشاء منشور

POST /public/v1/posts

ينشئ منشورًا. وبحسب type يصبح مسودة، أو يذهب إلى التقويم لوقت مستقبلي، أو ينشر فورًا. والاستدعاء الواحد يستطيع استهداف قنوات كثيرة دفعة واحدة.

وهذا أكبر جسم طلب في API والعملية المقيدة الوحيدة.

إن كنت تفعل ذلك من التطبيق، فراجع إنشاء المنشورات وجدولتها. وهذه العملية متاحة أيضًا بالأمر sharek posts:create في أداة CLI من شارك، وبالأداة integrationSchedulePostTool في خادم MCP من شارك.

الحقل مطلوب الوصف
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.
الحقل مطلوب الوصف
integration.id نعم القناة التي ينشر إليها، من سرد القنوات.
value نعم مصفوفة بمدخل واحد على الأقل. فالمدخل الواحد منشور مفرد؛ وعدة مدخلات تصنع سلسلة نقاش، كل واحد يرد على سابقه.
value[].content نعم نص المنشور. ويجوز أن يكون نصًا فارغًا فقط إن حمل ذلك المدخل صورة واحدة على الأقل.
value[].image نعم مصفوفة وسائط. ومصفوفة فارغة حين لا توجد.
value[].delay لا الدقائق التي تنتظر قبل هذا المدخل في سلسلة النقاش.
value[].id لا معرف منشور أو رد قائم، لتحديثه في مكانه بدل إنشاء جديد.
settings لا خيارات المزود. وإغفاله يساوي إرسال {}، وهو ما يرفضه المزود الذي له خيارات مطلوبة.
group لا قيمة group لمنشور قائم يحل هذا المدخل محله. فيزال المنشور القديم، ويأخذ الجديد group خاصًا به.

لا يوجد تاريخ لكل قناة: فأي date داخل مدخل من مدخلات posts يتجاهل، وdate في المستوى الأعلى ينطبق على كل قنوات الاستدعاء. وللنشر في أوقات مختلفة، اجعل لكل وقت استدعاءً مستقلًا.

الوسائط يجب أن ترفع أولًا. خذ id وpath مباشرة من رفع ملف أو الرفع من عنوان. ولملف موجود أصلًا في مكتبة الوسائط، يعيد سرد الوسائط الزوج نفسه.

الحقل مطلوب الوصف
id نعم معرف الوسائط الذي يعيده الرفع.
path نعم عنوان الوسائط الذي يعيده الرفع. ويجب أن ينتهي بـ .png أو .jpg أو .jpeg أو .gif أو .webp أو .mp4.
alt لا النص البديل.
thumbnail لا عنوان الصورة المصغرة.

مميز المزود داخل settings يملؤه شارك من القناة التي سميتها، وأي قيمة ترسلها تستبدل. أرسل خيارات المزود الحقيقية فقط:

"settings": { "title": "My video", "type": "public" }

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

جدولة منشور نصي واحد:

Terminal window
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": {}
}
]
}'

جدولة منشور بصورة:

Terminal window
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 تصير ردودًا:

Terminal window
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": {}
}
]
}'

مدخل واحد لكل قناة في الطلب:

[
{ "postId": "post-id", "integration": "channel-id" }
]

احتفظ بـ postId. فهو ما تأخذه تغيير الحالة وتحديث الإعدادات والحذف وتحليلات المنشور جميعًا.

type ما الذي يحدث
draft يحفظ في التقويم، ولا ينشر من تلقاء نفسه أبدًا. جدوِله لاحقًا بـ تغيير الحالة.
schedule يوضع في قائمة الانتظار لـ date.
now ينشر فورًا. وdate ما زال مطلوبًا.
update يحفظ التعديلات على المنشورات التي تسميها value[].id في مكانها ويبقي حالتها. ولا يبدأ تشغيل النشر بنفسه. أما بلا تلك المعرفات فينشئ منشورات مجدولة جديدة، ينشرها فحص شارك الذي يجري كل ساعة بحثًا عن المنشورات الفائتة بعد مرور date (ما لم يكن date أقدم من يومين)، لذا أرسل المعرفات دائمًا.

وقبول الاستدعاء ليس كنشره. فحين يفشل منشور عند نشره، يرفع شارك إشعارًا تعيده سرد الإشعارات، وقد تعرض سرد المنشورات سبب المنصة في error.

يجري شارك الفحوص نفسها التي يجريها المحرر، ويعيد أول إخفاق بـ 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 استدعاء إنشاء في الساعة الماضية.