مرجع API

تبديل التفاعل

يبدّل تفاعلًا واحدًا أو يغيّره للزائر أو ملف المجتمع الموثق على مقال منشور.

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

نموذج الوصول

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

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

المعاملات

الاسم	النوع	التحقق من المدخلات
`slug`مطلوب معرّف مناسب للرابط للحملة القائمة أو المقال المنشور.	`string`	التحقق: معرّف نصي عام في الرابط.

الطلب

الاسم	النوع	التحقق من المدخلات
`type`مطلوب نوع مورد أو تفاعل أو تصفية حملة يدعمه هذا المسار.	`enum`	التحقق: like \| love \| insightful \| celebrate \| clap.
`visitorId`مطلوب هوية الزائر المستخدمة لقراءة تفاعله مع المقال أو تبديله.	`string`	التحقق: 6–80.
`profileToken`اختياري رمز ملف مجتمع موثق قائم؛ ولا ينشئ هذا المسار الهوية.	`string`	التحقق: ملف مجتمع موجود وموثّق.

الطلب

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

POST /api/public/blog/:slug/reactions

http

POST /api/public/blog/example-campaign/reactions HTTP/1.1
Host: api.sparkglim.net
Content-Type: application/json

{
  "type": "like",
  "visitorId": "example_visitor_0001"
}

الاستجابة

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

json

{
  "success": true,
  "reacted": true
}

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

json

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

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

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

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

توافق المصدر

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

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

نموذج الوصول

المعاملات

الطلب

الطلب

الاستجابة

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

توافق المصدر

تابع التطوير