مرجع API

اكتشاف الحملات العامة

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

GEThttps://api.sparkglim.net/api/public/homepage/discovery

نموذج الوصول

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

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

أعد فقط السجلات المسموحة وفق الحساب والحملة وإعدادات الظهور.

المعاملات

الاسم	النوع	التحقق من المدخلات
`q`اختياري نص بحث يطابق العنوان والوصف والمنظم والموقع أو المستفيد العامين حسب الحملة.	`string`	التحقق: <=100.
`country`اختياري تصفية ببلد الحملة المهيأ؛ لا تفعّل وسائل الدفع ولا تحوّل العملة.	`string`	التحقق: ISO2.
`location`اختياري موقع الحملة العام أو مرشح الموقع؛ وهو منفصل عن بلد البيع المالي.	`string`	التحقق: <=100.
`type`اختياري نوع مورد أو تفاعل أو تصفية حملة يدعمه هذا المسار.	`enum`	التحقق: all \| ticketing \| voting \| donation.
`status`اختياري الحالة المدعومة المطلوبة؛ وتتحكم قواعد الموافقة في النشر والوصول.	`enum`	التحقق: all \| active \| upcoming \| ended \| postponed.
`sort`اختياري يحدد ترتيب الخادم المدعوم حسب التمييز أو الأحدث أو الإغلاق.	`enum`	التحقق: featured \| latest \| ending.
`date`اختياري يقيد الاكتشاف بنافذة التاريخ الموثقة في مرشح الخادم القائم.	`enum`	التحقق: all \| today \| tomorrow \| weekend \| month.
`page`اختياري صفحة النتائج المطلوبة وفق ترقيم المسار الموثق؛ احتفظ ببيانات التقسيم من الخادم.	`integer`	التحقق: 1–1000000.
`limit`اختياري أقصى عدد سجلات في الصفحة؛ ويطبق الحد الثابت لنقطة النهاية.	`integer`	التحقق: 1–24؛ القيمة الافتراضية: 12.

الطلب

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

GET /api/public/homepage/discovery

http

GET /api/public/homepage/discovery HTTP/1.1
Host: api.sparkglim.net

الاستجابة

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

json

{
  "success": true,
  "data": {
    "entries": [],
    "countries": [],
    "locations": [],
    "pagination": {
      "page": 1,
      "limit": 12,
      "total": 0,
      "pages": 0,
      "hasMore": false
    },
    "available": true
  }
}

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

json

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

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

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

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

توافق المصدر

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

server/src/api/routes/public-homepage.ts