الانتقال إلى الوثائق
SparkGlimDeveloper
مركز التكامل بمساعدة الذكاء الاصطناعي
SparkGlimSparkGlim للمطوّرين
ابحث في جميع الوثائق

جرّب موضوعًا بلغتك أو مسار API دقيقًا.

    مرجع API

    البحث العام بالرمز

    يعثر على مرشح معتمد أو حملة تصويت عامة برمز أو رابط وفق حدود الظهور والفئات النشطة الحالية.

    GEThttps://sparkglim.net/api/participants/search

    نموذج الوصول

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

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

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

    المعاملات

    الاسمالنوعالتحقق من المدخلات
    codeمطلوب

    اعتماد المورد أو رمز التحقق المطلوب للمسار؛ لا تنشر OTP حقيقيًا أو سر تذكرة.

    stringالتحقق: رمز مرشّح أو مشارك أو حملة أو معرّف الحملة النصي؛ يُقبل q كاسم بديل.

    الطلب

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

    GET /api/participants/search
    http
    GET /api/participants/search?code=EXAMPLE HTTP/1.1
    Host: sparkglim.net

    الاستجابة

    استجابة النجاح · HTTP 200
    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
      }
    }
    استجابة الخطأ · HTTP 400
    json
    {
      "error": "No nominee or digital voting campaign found for this code"
    }

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

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

    لا يحدد معالج الويب حدًا خاصًا في مصدره؛ وقد تنطبق ضوابط سابقة.

    توافق المصدر

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

    • app/api/participants/search/route.ts