مرجع API
حملات الجوائز العامة
يعيد حتى200 حملة تصويت عامة معتمدة أو منتهية أو مؤجلة مرتبة بالتمييز وتاريخ الإنشاء.
GET
https://api.sparkglim.net/api/public/homepage/awardsنموذج الوصول
- نموذج الوصول
- وصول عام مع تحقق
- التوفر الموثّق
- منفذ في المصدر
التوفر موثق من المصدر وليس ضمانًا لتشغيل الإنتاج.
حملات تصويت فقط بحد200 دون تقسيم صفحات.
المعاملات
| الاسم | النوع | التحقق من المدخلات |
|---|---|---|
countryاختياريتصفية ببلد الحملة المهيأ؛ لا تفعّل وسائل الدفع ولا تحوّل العملة. | string | التحقق: ISO2. |
الطلب
تصف الأمثلة العقد ولا تُنفذ. استخدم سجلات اختبار مصرحًا بها، ولا تلصق أسرارًا حقيقية في هذه الصفحات.
http
GET /api/public/homepage/awards HTTP/1.1
Host: api.sparkglim.netالاستجابة
json
{
"success": true,
"data": {
"campaigns": [],
"countries": [],
"available": true
}
}json
{
"success": false,
"error": "<ERROR_MESSAGE>"
}تستخدم أخطاء التحقق والصلاحيات والموارد والأعطال حالة HTTP وبنية الخطأ الخاصة بالمعالج.
الحدود وإعادة المحاولة
الحد الافتراضي: 100 طلب لكل عنوان IP خلال 60 ثانية، مع ضوابط إضافية حسب المورد.
توافق المصدر
تتطلب العمليات المصرح بها اختبارًا خاصًا بالحساب.
server/src/api/routes/public-homepage.ts