إيجاد الموعد الشاغر التالي
GET /public/v1/find-slot/{id}يعيد الوقت الشاغر التالي من الفترات الزمنية المضبوطة لهذه القناة. والفترة تعد مشغولة متى وجد في تلك الدقيقة أي منشور في مؤسستك، على أي قناة وبأي حالة، والمسودات منها.
استخدمه حين تريد وضع منشور في قائمة الانتظار دون اختيار وقت بنفسك: استدع هذا، ثم مرر
النتيجة مباشرة إلى إنشاء منشور في date.
إن كنت تفعل ذلك من التطبيق، فراجع التقويم. وهذه العملية لا يقابلها أمر في أداة CLI من شارك، ولا أداة في خادم MCP من شارك.
معاملات المسار
Section titled “معاملات المسار”| المعامل | مطلوب | الوصف |
|---|---|---|
id |
نعم | معرف التكامل من سرد القنوات. |
curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/find-slot/channel-idالاستجابة
Section titled “الاستجابة”{ "date": "2026-09-01T10:00:00" }الوقت بتوقيت UTC، ومكتوب بالصيغة YYYY-MM-DDTHH:mm:00 بلا Z وبلا أجزاء من الثانية.
وإنشاء منشور يقرؤه بتوقيت UTC، فمرره كما هو.
ملاحظات
Section titled “ملاحظات”- الجواب يعكس اللحظة التي سألت فيها. فاستدعاءان متتاليان قد يعيدان الموعد نفسه، لأن لا شيء يحجز إلى أن تنشئ المنشور فعلًا. فإن كنت تضع عدة منشورات في حلقة، فأنشئ كل واحد قبل أن تسأل عن الموعد التالي.
- الفترات الزمنية تضبط لكل قناة في التطبيق، تحت تعديل الفترات الزمنية في قائمة القناة. والقناة التي لا فترات مضبوطة لها، أو المعطلة، ترجع إلى 02:00 و06:40 و11:40 بتوقيت UTC.
- يبدأ البحث من اليوم ويمتد حتى 365 يومًا. فإن كانت كل الفترات في هذا المدى مشغولة، توقف البحث وأجاب مع ذلك بوقت يقع بعد هذا المدى مباشرة.