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

سرد الإشعارات

GET /public/v1/notifications

يعيد الإشعارات التي رفعها شارك لمؤسستك: إخفاقات النشر، والقنوات التي تحتاج إعادة ربط، والأحداث المشابهة. وهذا هو جانب API من الجرس في التطبيق. وحين يبلغ أحدها عن منشور فشل، يعرض سرد المنشورات ذلك المنشور وقيمة state فيه ERROR.

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

المعامل مطلوب الوصف
page لا رقم الصفحة، يبدأ من صفر. والقيمة الافتراضية 0. ويجب أن يكون 0 أو أكبر.

الصفحة الأولى:

Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/notifications

الصفحة الثانية:

Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/notifications?page=1"
{
"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 حين توجد صفحات أخرى.
  • حجم الصفحة ثابت عند 100 ولا يمكن تغييره. فلا يوجد معامل limit؛ وlimit في الاستجابة للعلم فقط.
  • تجاوز آخر صفحة يعطيك مصفوفة notifications فارغة مع hasMore: false، لا خطأً.
  • كرر الطلب ما دامت hasMore تساوي true بدل حساب الصفحات من total، لأن إشعارات جديدة قد تصل بين الطلبات فتتغير مواضع العناصر في الصفحات.
  • قراءة الإشعارات هنا لا تجعلها مقروءة.
  • هذا الاستدعاء غير مقيد؛ فالتقييد على إنشاء المنشورات وحده (انظر حد الطلبات).