مرجع API

ملخص التبرعات العام

يعيد تجميع التبرعات القديم مجاميع وسجلات دون حد الظهور العام الصارم الحالي؛ ولا يوصى به لتكامل جديد.

GEThttps://api.sparkglim.net/api/public/donation-summary/:campaignId

نموذج الوصول

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

يفتقد التجميع القديم حدود الظهور العام الحالية الكاملة؛ ولا يوصى به لتكاملات جديدة.

الاسم	النوع	التحقق من المدخلات
`campaignId`مطلوب سجل حملة قائم ضمن حساب الطالب وأي نطاق أضيق لمفتاح الحملة.	`string`	التحقق: UUID أو معرّف مورد موثّق.

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

غير متاح في العقد الموثّق

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

json

{
  "success": true,
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "pending"
  }
}

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

json

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

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

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

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