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

سرد المنشورات

GET /public/v1/posts

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

إن كنت تفعل ذلك من التطبيق، فراجع التقويم. وهذه العملية متاحة أيضًا بالأمر sharek posts:list في أداة CLI من شارك، وبالأداة postsListTool في خادم MCP من شارك.

المعامل مطلوب الوصف
startDate نعم تاريخ ووقت بصيغة ISO 8601. بداية النافذة.
endDate نعم تاريخ ووقت بصيغة ISO 8601. نهاية النافذة.
customer لا معرف علامة تجارية من سرد العلامات التجارية. يحصر النتائج في قنوات تلك العلامة التجارية. ويسميها التطبيق العلامات التجارية، أما API فيسميها groups في مساره وcustomer في حقوله.

والتاريخان مطلوبان كلاهما، وكلاهما بتوقيت UTC. والتاريخ الناقص أو المشوه يعيد 400 بشكل التحقق من الحقول.

Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/posts?startDate=2026-09-01T00:00:00.000Z&endDate=2026-09-30T23:59:59.000Z"
{
"posts": [
{
"id": "post-id",
"content": "Hello from the Sharek API",
"publishDate": "2026-09-01T10:00:00.000Z",
"releaseURL": null,
"releaseId": null,
"state": "QUEUE",
"error": null,
"intervalInDays": null,
"group": "group-id",
"creationMethod": "API",
"settings": "{\"who_can_reply_post\":\"everyone\",\"__type\":\"x\"}",
"tags": [
{
"tag": {
"id": "tag-id",
"name": "Launch",
"color": "#942828",
"orgId": "org-id",
"deletedAt": null,
"createdAt": "2026-08-20T09:00:00.000Z",
"updatedAt": "2026-08-20T09:00:00.000Z"
}
}
],
"integration": {
"id": "channel-id",
"providerIdentifier": "x",
"name": "Sharek on X",
"picture": "https://example.com/avatar.png"
}
}
]
}

وخلافًا لـ سرد القنوات، تغلف هذه العملية مصفوفتها في كائن.

الحقل الوصف
id معرف المنشور، لكل عملية منشورات أخرى.
content نص المنشور.
publishDate الموعد المجدول له، أو موعد نشره.
releaseURL رابط المنشور على المنصة بعد نشره، متى وجد.
releaseId معرف المنصة نفسها للعنصر المنشور. والنص الحرفي missing يعني أن شارك لم يستطع مطابقته، وهو ما وجد له المحتوى المفقود.
state QUEUE مجدول، وDRAFT مسودة، وPUBLISHED تم نشره، وERROR فشل.
error سبب رفض المنصة للمنشور، حين تعطي سببًا مقروءًا. وإلا فـ null.
intervalInDays يضبط حين يتكرر المنشور. وnull للمنشور لمرة واحدة.
group المجموعة التي يتشاركها هذا المنشور مع الردود في سلسلة النقاش الخاصة به. ولمنشور كل قناة مجموعته الخاصة، لذا فـ الحذف بالمجموعة يزيل هذا المنشور وردوده فقط.
creationMethod كيف أنشئ، مثل API أو CLI.
settings إعدادات القناة التي حفظ بها المنشور، بصيغة نص JSON. حلل النص قبل قراءة القيم.
tags وسوم المنشور، كل وسم منها داخل كائن tag.
integration القناة التي ينتمي إليها.

ولا تعاد إلا المنشورات ذات المستوى الأعلى. فالردود في سلسلة النقاش أبناء لمنشورها ولا تظهر كمدخلات منفصلة.

  • بلا ترقيم صفحات. فكل ما في النافذة يعود في استجابة واحدة، لذا اجعل النوافذ معقولة بدل طلب سنة كاملة دفعة واحدة.
  • المنشورات المتكررة تفرد داخل النافذة. فالمنشور المتكرر يعود مرة لكل تكرار يقع بين startDate وendDate. ويحمل كل مدخل وقت ذلك التكرار في publishDate، مع حفظ وقت السلسلة الأصلي في actualDate. والسلسلة التي بدأت قبل startDate لا تظهر إلا عبر تكراراتها الواقعة داخل النافذة.
  • منشور واحد لكل قناة. فاستدعاء إنشاء واحد عبر ثلاث قنوات يظهر هنا ثلاثة منشورات، لكل منها id وgroup خاصان به.
  • منشورات القنوات المحذوفة مستبعدة.