كيف تبني جدولة لمنشورات السوشال ميديا عبر API: الطابور والوسائط وحالات المنشورات
لبناء جدولة منشورات للسوشال ميديا عبر واجهة برمجة التطبيقات (API) للشركاء في easyCoexistence، يرسل الخادم الخاص بك كل منشور إلى POST /channels/:id/posts مع نصه ووسائطه وpublish_at بموعد من دقيقة واحدة إلى 90 يومًا مقدمًا. ينسخ easyCoexistence الوسائط فورًا وينشر المنشور في موعده على Instagram وFacebook وTikTok وLinkedIn، ويبلغ عن كل خطوة كحالة وعبر الأحداث post.published وpost.failed.
المدى الذي تجدول فيه واجهة posts المنشورات مقدّمًا على Instagram وFacebook وTikTok وLinkedIn؛ وأقرب موعد دقيقة واحدة.
أكبر صورة وأكبر فيديو ينسخهما easyCoexistence عند جدولة المنشور؛ الملف الأكبر يُرفض في تلك اللحظة.
متى يُعاد نشر منشور حدّت الشبكة من معدل إرساله، قبل وسمه بالفشل.
عدد المنشورات التي يمكن لحساب Instagram نشرها عبر API خلال 24 ساعة متحركة؛ الكاروسيل يُحسب منشورًا واحدًا.
حد TikTok لمنشورات الفيديو لكل حساب عبر نقطة النهاية (endpoint) الخاصة بالنشر، بحد أقصى ستة في الدقيقة.
ما الذي تحتاجه الجدولة من الواجهة؟
خمسة أشياء: مكان لرفع الملفات، ونداء يضع منشورًا واحدًا لحساب في الطابور، وطابور ينشر في موعده، وطريقة لتغيير القرار، وإعلام بما حدث. تمنح واجهة posts كل واحد منها بمفتاح ec_live_ نفسه الذي يربط عملاءك، فيبقى التقويم وتدفق الموافقات ومحرر المنشورات داخل منتجك.
كيف تجدول منشورًا؟
بطلب POST واحد لكل حساب إلى https://easycoexistence.com/api/v1/channels/:id/posts، حيث يكون :id هو channel_id من جلسة الربط لدى العميل. يكون publish_at بصيغة ISO 8601 مع Z أو فرق توقيت، ويُترك فارغًا للنشر فورًا. تكون الاستجابة 201 مع المنشور، أو 422 إذا فشل منشور مخصص للنشر الفوري. تُعتمد الترويسة Idempotency-Key، فلا يُجدول المنشور مرتين إذا أُعيد الطلب بعد انتهاء المهلة. يقبل الجسم الحقول التالية:
- text: نص التعليق أو الرسالة؛ media: قائمة من {url, type} أو {
media_id}. - link: منشور رابط على Facebook أو مقالة على LinkedIn، مع عنوان على LinkedIn.
ig_type: إحدى القيم IMAGE أو CAROUSEL أو REELS أو STORIES، وتُستنتج من الوسائط إذا حُذفت.- title و
disable_commentلمنشورات الصور على TikTok؛ وimage_altلصورة LinkedIn.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Idempotency-Key: campaign-311-ig" \
-H "Content-Type: application/json" \
-d '{
"text": "Three looks for the weekend",
"media": [
{ "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
],
"ig_type": "CAROUSEL",
"publish_at": "2026-11-20T09:00:00-05:00"
}'كيف تتعامل الجدولة مع الوسائط؟
إما بالرابط أو بالرفع. يُوضع الرابط العام عبر HTTPS مباشرة في media؛ أما الملف الذي يرفعه المستخدم فيُرسل إلى POST /media بوصفه جسم الطلب مع Content-Type وContent-Length، أو كـ {"url"}، ويُضاف media_id الذي يعيده إلى المنشور. عند جدولة المنشور ينسخ easyCoexistence ملفاته، فيكفي أن يعمل رابطك في تلك اللحظة. تُرفض صفحة ويب بدل ملف، أو 404، أو نوع خاطئ، أو ملف يتجاوز 30 MB للصور أو 1 GB للفيديو، في تلك اللحظة، لا صباح يوم النشر.
ما الذي يحمله منشور كل شبكة؟
تفحص الطابور كل منشور مقابل قواعد الشبكة قبل قبوله، ويُرفض المنشور الذي يخرقها برسالة تذكر القاعدة، فيستطيع محررك إظهار المشكلة والمستخدم ما زال يحرر. تقبل كل شبكة:
بأي حالات يمر المنشور؟
ست حالات، يعرضها GET /posts/:id وGET /posts إلى جانب publish_at، ورابط المنشور بعد نشره، وخطأ الشبكة عند الفشل:
- scheduled: في الطابور بانتظار موعده.
- publishing: سُلّم إلى الشبكة.
- processing: ما زالت الشبكة تعمل عليه، كما في فيديو TikTok أو حاوية Instagram.
- published: منشور ومتاح، مع رابطه.
- failed: رُفض أو لم يُؤكَّد؛ ويُعلّم
may_be_publishedالمنشور الذي ربما استلمته الشبكة. - canceled: أُزيل قبل نشره، من قِبلك أو لأن قناته أُزيلت أو عُلّقت.
كيف تعدل منشورًا أو تلغيه أو تعيد محاولته؟
يغيّر PATCH /posts/:id موعد المنشور المجدول أو نصه، وعنوان منشور الصور على TikTok؛ ولتغيير وسائطه ألغِه وجدول منشورًا جديدًا. يلغي DELETE /posts/:id المنشور. يعيد POST /posts/:id/retry نشر منشور فشل الآن. تُعاد محاولة المنشور الذي حدّت الشبكة من معدله تلقائيًا بعد 5 دقائق ثم 30 دقيقة ثم ساعتين، ويحتاج المنشور المعلَّم may_be_published إلى فحص الحساب قبل أي إعادة محاولة.
كيف تسمع الجدولة بما حدث؟
من الأحداث ومن القائمة. يستقبل عنوان أحداث الحالة المضبوط من الملف الشخصي ثم Developers وسم post.published وpost.failed، وهو موقّع بـ X-EC-Signature مثل كل حدث آخر، مع المنشور وقناته، فيعلّم تقويمك كل منشور نشطًا أو يُبلغ عن فشله. يقبل GET /posts المعاملات status وfrom وto وlimit لعروض التقويم، ويسرد GET /channels/:id/posts حسابًا واحدًا. ويُرسل المنشور الذي يفشل في الخلفية بريدًا إلى مالك حسابك، مرة واحدة على الأكثر لكل قناة كل 3 ساعات.
كيف تتناسب منشورات LinkedIn مع الجدولة؟
بموافقة شخص على كل منشور. تقيّد شروط واجهة برمجة تطبيقات LinkedIn استخدام واجهاتها لأتمتة النشر، لذا تُبقي الجدولة كل منشور LinkedIn مسودةً في منتجك حتى يوافق عليه شخص محدد، ثم ترسله مع publish_at الخاص به. ينبغي أن تستهدف القواعد المتكررة والتغذيات والاستيراد الجماعي الشبكات الأخرى، وأن تُترك LinkedIn للمنشورات التي راجعها أحدهم.
الأخطاء الشائعة
- إرسال publish_at بلا فرق توقيت. يُرفض الوقت المحلي دون Z أو فرق توقيت، فأرسل 2026-11-20T09:00:00-05:00 لا وقت الساعة المجرد الذي اختاره المستخدم.
- إعادة محاولة منشور مُعلَّم may_be_published فورًا. ربما تعرضه الشبكة بالفعل، فافحص الحساب أولًا، وإلا خرج المنشور مرتين.
- تكرار طلب POST انتهت مهلته دون Idempotency-Key. أعطِ كل منشور مفتاحه الخاص، فيعيد الطلب المكرر المنشور المصطف في الطابور بدل جدولة نسخة ثانية.
- ربط ملفات PNG لـ Instagram. لا تقبل واجهة النشر في Instagram إلا JPEG، ويُرفض المنشور عند جدولته، فحوّل الصور في خطوة الرفع لديك.
يمنح easyCoexistence جدولتك طابورًا واحدًا لحسابات عملائك على Instagram وFacebook وTikTok وLinkedIn، وقنوات أخرى أيضًا، عبر واجهة كل شبكة الرسمية: وسائط تُنسخ عند جدولة المنشور، وست حالات، وإعادة محاولة عند حدود المعدل، وأحداث منشورات موقّعة، مع مراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال في الشهر، ويقل السعر كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل يمكن لطلب واحد أن يجدول منشورًا على عدة شبكات؟
يستهدف كل طلب قناة واحدة، فأرسل طلبًا لكل حساب، ولكل منه Idempotency-Key خاص، وكيّف النص مع حدود كل شبكة.
هل تجدول واجهة posts فيديوهات YouTube؟
تجدول YouTube ذلك بنفسها. ارفع الفيديو عبر واجهة YouTube كخاص مع publishAt، مستخدمًا رمز الوصول (token) من GET /channels/:id?credentials=1، فيجعله YouTube عامًا في ذلك الموعد.
هل يرى مستخدموي منشوراتهم المجدولة في لوحة تحكم easyCoexistence؟
شاشة Posts تتبع حسابك، فيرى فريقك فيها «يحتاج إلى انتباه» و«قادم» و«منشور»، مع خيارات إلغاء وإعادة محاولة وتجاهل. ويرى مستخدموك التقويم الذي تبنيه منتجك من GET /posts.
كم تكلف easyCoexistence لجدولة منشورات السوشال ميديا؟
من US$ 9 إلى US$ 0.75 لكل حساب متصل في الشهر، ويقل كلما ربط مستخدموك حسابات أكثر، والجدولة مشمولة، مع أول 3 أيام مجانًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في