مرجع API
أعداد أصوات عامة حسب الظهور
يعيد مجاميع الأصوات المكتملة لحملة عامة ومرشحين معتمدين وفئات نشطة عند السماح الصريح بنشر الأعداد.
GET
https://sparkglim.net/api/public/voting-counts/:campaignIdنموذج الوصول
- نموذج الوصول
- وصول عام مع تحقق
- التوفر الموثّق
- منفذ في المصدر
التوفر موثق من المصدر وليس ضمانًا لتشغيل الإنتاج.
أعد فقط السجلات المسموحة وفق الحساب والحملة وإعدادات الظهور.
المعاملات
| الاسم | النوع | التحقق من المدخلات |
|---|---|---|
campaignIdمطلوبسجل حملة قائم ضمن حساب الطالب وأي نطاق أضيق لمفتاح الحملة. | string | التحقق: UUID أو معرّف مورد موثّق. |
الطلب
تصف الأمثلة العقد ولا تُنفذ. استخدم سجلات اختبار مصرحًا بها، ولا تلصق أسرارًا حقيقية في هذه الصفحات.
http
GET /api/public/voting-counts/11111111-1111-4111-8111-111111111111 HTTP/1.1
Host: sparkglim.netالاستجابة
json
{
"success": true,
"data": {
"visible": false,
"voteCounts": {}
}
}json
{
"success": false
}تستخدم أخطاء التحقق والصلاحيات والموارد والأعطال حالة HTTP وبنية الخطأ الخاصة بالمعالج.
الحدود وإعادة المحاولة
لا يحدد معالج الويب حدًا خاصًا في مصدره؛ وقد تنطبق ضوابط سابقة.
توافق المصدر
تتطلب العمليات المصرح بها اختبارًا خاصًا بالحساب.
app/api/public/voting-counts/[campaignId]/route.ts