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

إيجاد الموعد الشاغر التالي

GET /public/v1/find-slot/{id}

يعيد الوقت الشاغر التالي من الفترات الزمنية المضبوطة لهذه القناة. والفترة تعد مشغولة متى وجد في تلك الدقيقة أي منشور في مؤسستك، على أي قناة وبأي حالة، والمسودات منها.

استخدمه حين تريد وضع منشور في قائمة الانتظار دون اختيار وقت بنفسك: استدع هذا، ثم مرر النتيجة مباشرة إلى إنشاء منشور في date.

إن كنت تفعل ذلك من التطبيق، فراجع التقويم. وهذه العملية لا يقابلها أمر في أداة CLI من شارك، ولا أداة في خادم MCP من شارك.

المعامل مطلوب الوصف
id نعم معرف التكامل من سرد القنوات.
Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/find-slot/channel-id
{ "date": "2026-09-01T10:00:00" }

الوقت بتوقيت UTC، ومكتوب بالصيغة YYYY-MM-DDTHH:mm:00 بلا Z وبلا أجزاء من الثانية. وإنشاء منشور يقرؤه بتوقيت UTC، فمرره كما هو.

  • الجواب يعكس اللحظة التي سألت فيها. فاستدعاءان متتاليان قد يعيدان الموعد نفسه، لأن لا شيء يحجز إلى أن تنشئ المنشور فعلًا. فإن كنت تضع عدة منشورات في حلقة، فأنشئ كل واحد قبل أن تسأل عن الموعد التالي.
  • الفترات الزمنية تضبط لكل قناة في التطبيق، تحت تعديل الفترات الزمنية في قائمة القناة. والقناة التي لا فترات مضبوطة لها، أو المعطلة، ترجع إلى 02:00 و06:40 و11:40 بتوقيت UTC.
  • يبدأ البحث من اليوم ويمتد حتى 365 يومًا. فإن كانت كل الفترات في هذا المدى مشغولة، توقف البحث وأجاب مع ذلك بوقت يقع بعد هذا المدى مباشرة.