مرجع API

المقالات المنشورة

يسرد المقالات المنشورة مع البحث والفئة والتمييز وحد الصفحة والإزاحة وإجمالي دقيق.

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

نموذج الوصول

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

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

الاسم	النوع	التحقق من المدخلات
`category`اختياري فئة الحملة المهيأة أو فئة إعدادات معتمدة حسب المورد.	`string`	التحقق: المعرّف النصي للفئة في الرابط.
`search`اختياري مرشح نصي يطبق على السجلات المنشورة التي يحددها المسار.	`string`	التحقق: نص البحث.
`featured`اختياري يطلب مرشح المقالات المميزة القائم عندما تكون القيمة true.	`string`	التحقق: true.
`limit`اختياري أقصى عدد سجلات في الصفحة؛ ويطبق الحد الثابت لنقطة النهاية.	`number`	التحقق: 1–30؛ القيمة الافتراضية: 10.
`offset`اختياري عدد المقالات المنشورة التي تتجاوز قبل الصفحة بدءًا من الصفر.	`number`	التحقق: >=0؛ القيمة الافتراضية: 0.

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

GET /api/public/blog

http

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

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

json

{
  "success": true,
  "data": [],
  "count": 0,
  "limit": 10,
  "offset": 0
}

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

json

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

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

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

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