سرد الإشعارات
GET /public/v1/notificationsيعيد الإشعارات التي رفعها شارك لمؤسستك: إخفاقات النشر، والقنوات التي تحتاج إعادة ربط،
والأحداث المشابهة. وهذا هو جانب API من الجرس في التطبيق. وحين يبلغ أحدها عن منشور فشل،
يعرض سرد المنشورات ذلك المنشور وقيمة state فيه ERROR.
وهذه العملية لا يقابلها أمر في أداة CLI من شارك، ولا أداة في خادم MCP من شارك.
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | مطلوب | الوصف |
|---|---|---|
page |
لا | رقم الصفحة، يبدأ من صفر. والقيمة الافتراضية 0. ويجب أن يكون 0 أو أكبر. |
الصفحة الأولى:
curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/notificationsالصفحة الثانية:
curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/notifications?page=1"الاستجابة
Section titled “الاستجابة”{ "notifications": [ { "id": "notification-id", "content": "Your post to X failed to publish", "link": "https://dash.sharek.app/launches", "createdAt": "2026-09-01T10:00:00.000Z" } ], "total": 143, "page": 0, "limit": 100, "hasMore": true}| الحقل | الوصف |
|---|---|
notifications |
صفحة النتائج، الأحدث أولًا. |
total |
كم إشعارًا موجود إجمالًا، لا في هذه الصفحة وحدها. |
page |
رقم الصفحة الذي طلبته، يعود كما أرسلته. |
limit |
دائمًا 100. |
hasMore |
true حين توجد صفحات أخرى. |
ملاحظات
Section titled “ملاحظات”- حجم الصفحة ثابت عند 100 ولا يمكن تغييره. فلا يوجد معامل
limit؛ وlimitفي الاستجابة للعلم فقط. - تجاوز آخر صفحة يعطيك مصفوفة
notificationsفارغة معhasMore: false، لا خطأً. - كرر الطلب ما دامت
hasMoreتساويtrueبدل حساب الصفحات منtotal، لأن إشعارات جديدة قد تصل بين الطلبات فتتغير مواضع العناصر في الصفحات. - قراءة الإشعارات هنا لا تجعلها مقروءة.
- هذا الاستدعاء غير مقيد؛ فالتقييد على إنشاء المنشورات وحده (انظر حد الطلبات).