سرد المنشورات
GET /public/v1/postsيعيد المنشورات على تقويمك بين تاريخين. وهذا هو جانب القراءة من التقويم: استخدمه لمزامنة ما هو مجدول، أو لإيجاد معرف منشور لم تحتفظ به.
إن كنت تفعل ذلك من التطبيق، فراجع التقويم. وهذه العملية متاحة أيضًا
بالأمر sharek posts:list في أداة CLI من شارك، وبالأداة
postsListTool في خادم MCP من شارك.
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | مطلوب | الوصف |
|---|---|---|
startDate |
نعم | تاريخ ووقت بصيغة ISO 8601. بداية النافذة. |
endDate |
نعم | تاريخ ووقت بصيغة ISO 8601. نهاية النافذة. |
customer |
لا | معرف علامة تجارية من سرد العلامات التجارية. يحصر النتائج في قنوات تلك العلامة التجارية. ويسميها التطبيق العلامات التجارية، أما API فيسميها groups في مساره وcustomer في حقوله. |
والتاريخان مطلوبان كلاهما، وكلاهما بتوقيت UTC. والتاريخ الناقص أو المشوه يعيد 400
بشكل التحقق من الحقول.
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"الاستجابة
Section titled “الاستجابة”{ "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 |
القناة التي ينتمي إليها. |
ولا تعاد إلا المنشورات ذات المستوى الأعلى. فالردود في سلسلة النقاش أبناء لمنشورها ولا تظهر كمدخلات منفصلة.
ملاحظات
Section titled “ملاحظات”- بلا ترقيم صفحات. فكل ما في النافذة يعود في استجابة واحدة، لذا اجعل النوافذ معقولة بدل طلب سنة كاملة دفعة واحدة.
- المنشورات المتكررة تفرد داخل النافذة. فالمنشور المتكرر يعود مرة لكل تكرار يقع بين
startDateوendDate. ويحمل كل مدخل وقت ذلك التكرار فيpublishDate، مع حفظ وقت السلسلة الأصلي فيactualDate. والسلسلة التي بدأت قبلstartDateلا تظهر إلا عبر تكراراتها الواقعة داخل النافذة. - منشور واحد لكل قناة. فاستدعاء إنشاء واحد عبر ثلاث قنوات يظهر هنا
ثلاثة منشورات، لكل منها
idوgroupخاصان به. - منشورات القنوات المحذوفة مستبعدة.