مرجع API

إرسال تعليق للمراجعة

يرسل تعليقًا من ملف مجتمع موثق قائم وفق إعدادات المقال وسياسة المراجعة.

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

نموذج الوصول

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

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

يلزم ملف موثق قائم وقد يبقى التعليق معلقًا؛ ولا يفترض إنشاء هوية عبر واجهة عامة.

المعاملات

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

الطلب

الاسم	النوع	التحقق من المدخلات
`content`مطلوب نص تعليق يرسله ملف مجتمع موثق قائم؛ وتظل المراجعة مطبقة.	`string`	التحقق: 2–4000.
`profileToken`مطلوب رمز ملف مجتمع موثق قائم؛ ولا ينشئ هذا المسار الهوية.	`string`	التحقق: ملف مجتمع موجود وموثّق تتطلبه دالة المعالجة.

الطلب

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

POST /api/public/blog/:slug/comments

http

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

{
  "content": "Example comment text.",
  "profileToken": "<VERIFIED_COMMUNITY_PROFILE_TOKEN>"
}

الاستجابة

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

json

{
  "success": true,
  "moderated": true,
  "message": "Your comment is awaiting moderation."
}

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

json

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

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

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

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

توافق المصدر

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

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

نموذج الوصول

المعاملات

الطلب

الطلب

الاستجابة

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

توافق المصدر

تابع التطوير