مرجع API

قراءة التفاعلات

يحصي تفاعلات مقال منشور ويحدد اختيارات الزائر الحالي دون إعادة هويات الآخرين.

GEThttps://api.sparkglim.net/api/public/blog/:slug/reactions

نموذج الوصول

نموذج الوصول: وصول عام مع تحقق
التوفر الموثّق: منفذ في المصدر

التوفر موثق من المصدر وليس ضمانًا لتشغيل الإنتاج.

المعاملات

الاسم	النوع	التحقق من المدخلات
`slug`مطلوب معرّف مناسب للرابط للحملة القائمة أو المقال المنشور.	`string`	التحقق: معرّف نصي عام في الرابط.
`visitorId`اختياري هوية الزائر المستخدمة لقراءة تفاعله مع المقال أو تبديله.	`string`	التحقق: هوية الزائر.
`profileToken`اختياري رمز ملف مجتمع موثق قائم؛ ولا ينشئ هذا المسار الهوية.	`string`	التحقق: ملف مجتمع موجود وموثّق.

الطلب

تصف الأمثلة العقد ولا تُنفذ. استخدم سجلات اختبار مصرحًا بها، ولا تلصق أسرارًا حقيقية في هذه الصفحات.

GET /api/public/blog/:slug/reactions

http

GET /api/public/blog/example-campaign/reactions HTTP/1.1
Host: api.sparkglim.net

الاستجابة

استجابة النجاح · HTTP 200

json

{
  "success": true,
  "data": {
    "counts": {
      "like": 0,
      "love": 0,
      "insightful": 0,
      "celebrate": 0,
      "clap": 0
    },
    "mine": []
  }
}

استجابة الخطأ · HTTP 400

json

{
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

تستخدم أخطاء التحقق والصلاحيات والموارد والأعطال حالة HTTP وبنية الخطأ الخاصة بالمعالج.

الحدود وإعادة المحاولة

الحد الافتراضي: 100 طلب لكل عنوان IP خلال 60 ثانية، مع ضوابط إضافية حسب المورد.

توافق المصدر

تتطلب العمليات المصرح بها اختبارًا خاصًا بالحساب.

server/src/api/router.ts
server/src/api/routes/public.ts