تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

كيف تبني جدولة لمنشورات السوشال ميديا عبر API: الطابور والوسائط وحالات المنشورات

لبناء جدولة منشورات للسوشال ميديا عبر واجهة برمجة التطبيقات (API) للشركاء في easyCoexistence، يرسل الخادم الخاص بك كل منشور إلى POST /channels/:id/posts مع نصه ووسائطه وpublish_at بموعد من دقيقة واحدة إلى 90 يومًا مقدمًا. ينسخ easyCoexistence الوسائط فورًا وينشر المنشور في موعده على Instagram وFacebook وTikTok وLinkedIn، ويبلغ عن كل خطوة كحالة وعبر الأحداث post.published وpost.failed.

90 days

المدى الذي تجدول فيه واجهة posts المنشورات مقدّمًا على Instagram وFacebook وTikTok وLinkedIn؛ وأقرب موعد دقيقة واحدة.

30 MB and 1 GB

أكبر صورة وأكبر فيديو ينسخهما easyCoexistence عند جدولة المنشور؛ الملف الأكبر يُرفض في تلك اللحظة.

5 min, 30 min, 2 h

متى يُعاد نشر منشور حدّت الشبكة من معدل إرساله، قبل وسمه بالفشل.

100 posts

عدد المنشورات التي يمكن لحساب Instagram نشرها عبر API خلال 24 ساعة متحركة؛ الكاروسيل يُحسب منشورًا واحدًا.

15 a day

حد TikTok لمنشورات الفيديو لكل حساب عبر نقطة النهاية (endpoint) الخاصة بالنشر، بحد أقصى ستة في الدقيقة.

ما الذي تحتاجه الجدولة من الواجهة؟

خمسة أشياء: مكان لرفع الملفات، ونداء يضع منشورًا واحدًا لحساب في الطابور، وطابور ينشر في موعده، وطريقة لتغيير القرار، وإعلام بما حدث. تمنح واجهة posts كل واحد منها بمفتاح ec_live_ نفسه الذي يربط عملاءك، فيبقى التقويم وتدفق الموافقات ومحرر المنشورات داخل منتجك.

1UploadPOST /media, or a public HTTPS link
2SchedulePOST /channels/:id/posts with publish_at
3HoldMedia copied, the post waits in the queue
4PublishThe network's official API, at the set time
5ReportStatus on GET /posts; post.published or post.failed

كيف تجدول منشورًا؟

بطلب 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.
Schedule an Instagram carousel
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 للفيديو، في تلك اللحظة، لا صباح يوم النشر.

ما الذي يحمله منشور كل شبكة؟

تفحص الطابور كل منشور مقابل قواعد الشبكة قبل قبوله، ويُرفض المنشور الذي يخرقها برسالة تذكر القاعدة، فيستطيع محررك إظهار المشكلة والمستخدم ما زال يحرر. تقبل كل شبكة:

InstagramOne JPEG, a carousel of 2 to 10 items, a Reel or a Story; up to 2,200 characters; no link.
FacebookText, a link, one image or one video on a Page, never a link and a file together.
TikTokOne video, or 1 to 35 JPEG or WebP images with a title of up to 90 characters.
LinkedInText of up to 3,000 characters with one image or a titled link; no video.

بأي حالات يمر المنشور؟

ست حالات، يعرضها 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

يمنح 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 أيام مجانًا.

تابع القراءة

واجهة برمجة لوسائل التواصل للوكالات: أدر حسابات عملائك من برمجياتك الخاصةواجهة برمجة للوكالات: اربط حسابات كل عميل عبر رابط مستضاف، ووسمها بمعرّف العميل، وانشر بعد الموافقة، ووجّه الردود، وأنشئ التقارير.بنية SaaS لوكلاء الذكاء الاصطناعي: الوصول إلى عملاء عملائك عبر WhatsApp وInstagram وTikTokهندسة SaaS لوكلاء الذكاء الاصطناعي التي ترد على عملاء عملائك: الاتصالات والاستقبال ومخزن المحادثات وعامل النموذج والإرسال الصادر.بناء مقابل شراء تكاملات وسائل التواصل الاجتماعي: واجهات Meta وTikTok وYouTube وLinkedIn لمنتج SaaSما يتطلبه بناء تكاملات Meta وTikTok وYouTube وLinkedIn بنفسك: مراجعات الوصول وتجديد الرموز والمراقبة، مقابل واجهة برمجة شريكة.كيف تعرف متى ينقطع اتصال واتساب أو حساب التواصل الاجتماعي لعميلكأحداث connection.* و channel.*: الحمولة، وأسباب مثل PRIMARY_INACTIVITY، والتوقيع X-EC-Signature، وإعادة المحاولة لنحو 33 ساعة، ومنع التكرار بالمعرّف idانشر على Instagram وTikTok وFacebook وYouTube وLinkedIn بواجهة API واحدةانشر وجدول منشورات Instagram وReels وStories وفيديوهات TikTok ومنشورات صفحات Facebook ورفع YouTube ومنشورات LinkedIn من Claude أو ChatGPT أو من كودك.جدولة المنشورات بالذكاء الاصطناعي في Claude و ChatGPTاطلب من Claude أو ChatGPT جدولة منشورات على Instagram وTikTok وLinkedIn وFacebook من طابور easyCoexistence، حتى 90 يومًا مقدمًا، وعلى YouTube بشكل أصلي.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في