مرجع API
البحث العام بالرمز
يعثر على مرشح معتمد أو حملة تصويت عامة برمز أو رابط وفق حدود الظهور والفئات النشطة الحالية.
GET
https://sparkglim.net/api/participants/searchنموذج الوصول
- نموذج الوصول
- وصول عام مع تحقق
- التوفر الموثّق
- منفذ في المصدر
التوفر موثق من المصدر وليس ضمانًا لتشغيل الإنتاج.
أعد فقط السجلات المسموحة وفق الحساب والحملة وإعدادات الظهور.
المعاملات
| الاسم | النوع | التحقق من المدخلات |
|---|---|---|
codeمطلوباعتماد المورد أو رمز التحقق المطلوب للمسار؛ لا تنشر OTP حقيقيًا أو سر تذكرة. | string | التحقق: رمز مرشّح أو مشارك أو حملة أو معرّف الحملة النصي؛ يُقبل q كاسم بديل. |
الطلب
تصف الأمثلة العقد ولا تُنفذ. استخدم سجلات اختبار مصرحًا بها، ولا تلصق أسرارًا حقيقية في هذه الصفحات.
http
GET /api/participants/search?code=EXAMPLE HTTP/1.1
Host: sparkglim.netالاستجابة
json
{
"success": true,
"resultType": "nominee",
"participant": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "Example nominee",
"bio": null,
"category": null,
"vote_count": null,
"show_vote_count": false,
"participant_code": "EXAMPLE",
"nominee_code": null,
"image_url": null
},
"campaign": {
"id": "11111111-1111-4111-8111-111111111111",
"title": "Example awards",
"slug": "example-awards",
"status": "approved",
"campaign_type": "voting",
"vote_price": 1,
"image_url": null,
"banner_url": null
}
}json
{
"error": "No nominee or digital voting campaign found for this code"
}تستخدم أخطاء التحقق والصلاحيات والموارد والأعطال حالة HTTP وبنية الخطأ الخاصة بالمعالج.
الحدود وإعادة المحاولة
لا يحدد معالج الويب حدًا خاصًا في مصدره؛ وقد تنطبق ضوابط سابقة.
توافق المصدر
تتطلب العمليات المصرح بها اختبارًا خاصًا بالحساب.
app/api/participants/search/route.ts