مرجع API

تفاصيل المقال المنشور

يعيد مقالًا منشورًا وحتى أربعة مقالات ذات صلة ويزيد عداد مشاهداته.

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

نموذج الوصول

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

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

افتح رابط الدفع المعاد؛ ويتحكم SparkGlim Server في الأسعار والوسائل والتحقق والتنفيذ، والعودة مجرد تنقل.

تزيد قراءة المقال عداد المشاهدات؛ لذا ليس GET فحصًا بلا تغيير.

المعاملات

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

الطلب

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

GET /api/public/blog/:slug

http

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

الاستجابة

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

json

{
  "success": true,
  "data": {
    "post": {
      "id": "11111111-1111-4111-8111-111111111111",
      "slug": "example-article",
      "title": "Example article",
      "status": "published"
    },
    "relatedPosts": []
  }
}

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

json

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

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

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

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

توافق المصدر

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

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