Skip to main content
كل ما يقوم به التقويم — ربط القنوات، وجدولة المنشورات، وقراءة الأداء — متاح عبر HTTP.

​
عنوان URL الأساسي

​
أول استدعاء لك

ابدأ من هنا: فكل مسار آخر تقريبًا يحتاج إلى id الخاص بالتكامل، ويحتاج النشر إلى identifier لمعرفة كائن الإعدادات الذي ينبغي إرساله.

​
قناة أم تكامل؟

تستخدم الواجهة مصطلح قناة، بينما تستخدم واجهة API مصطلح تكامل (integration). وهما الكائن نفسه — لم تتم مواءمة التسمية قط. يستخدم هذا المرجع مصطلح تكامل لأنه الاسم المستخدم في المسارات.

​
حدود المعدل

90 طلبًا في الساعة لكل منظمة، عبر جميع نقاط النهاية مجتمعة. يؤدي تجاوز هذا الحد إلى إرجاع 429. اجمع عمليات القراءة دفعةً واحدة حيثما أمكن — فاستدعاء GET /posts واحد محدد النطاق أفضل من الاستعلام المتكرر عن كل منشور على حدة.

​
الاختبار دون كتابة تعليمات برمجية

تحتوي كل صفحة نقطة نهاية في هذا المرجع على لوحة قابلة للتشغيل: الصق مفتاح API الخاص بك من Settings → Developers (الإعدادات ← المطوِّرون) في حقل Authorization، واملأ المعلمات، ثم اضغط Send (إرسال).
تتواصل اللوحة مع منظمتك الفعلية — فاستدعاء POST /posts من صفحات التوثيق ينشئ منشورًا حقيقيًا، وعملية الحذف تحذف فعلًا. اختبر الاستدعاءات المدمِّرة على مسودة، لا على حملة منشورة.

​
التواريخ

بصيغة ISO-8601، وبتوقيت UTC دائمًا. المنشور المجدول في 2026-09-01T09:00:00Z يُنشر في الساعة 09:00 بتوقيت UTC بغضّ النظر عن المنطقة الزمنية التي يعرضها الحساب.

​
النشر من البداية إلى النهاية

1

اعرض قائمة القنوات

GET /integrations — احتفظ بقيمتي id وidentifier.
2

ارفع الوسائط

POST /upload أو POST /upload-from-url إذا كان المنشور يحتاج إليها. احتفظ بمعرّف الوسائط id المُرجَع.
3

اختر وقتًا

GET /find-slot/{id} للحصول على أقرب موعد نشر متاح، أو اختر وقتًا بنفسك.
4

أنشئ المنشور

POST /posts مع القناة والمحتوى وكائن settings الخاص بتلك القناة.
5

تأكَّد

GET /posts خلال الفترة الزمنية، وGET /analytics/post/{id} بعد أن يصبح المنشور منشورًا فعليًا.
هل تبني شيئًا على مراحل؟ أنشئ المنشورات بقيمة "type": "draft" — فالمسودات تتخطى التحقق من صحة الإعدادات، ما يتيح لك تجميع المنشور عبر عدة استدعاءات، ثم استخدام /posts/{id}/missing لمعرفة ما لا يزال ناقصًا.