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

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

    مرجع API

    التحقق من تحدي الرمز

    يتحقق من تحدٍّ غير منتهٍ تابع لحساب الموزع المصرح ويؤشر ذلك التحدي وحده كموثق.

    POSThttps://api.sparkglim.net/api/white-label/portal/reseller/otp/:challengeId/verify

    نموذج الوصول

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

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

    استخدم مسار أعضاء فريق المنشئ؛ ولا تمنح إعادة البيع وصولًا غير محدود للبيانات أو الإدارة.

    الترويسات

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

    جلسة SparkGlim حاملة قائمة؛ وتحدد عضوية الحساب والصلاحيات المعينة السماح بكل عملية.

    stringالتحقق: رمز Bearer لجلسة مصادقة موجودة.

    المعاملات

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

    معرّف طلب OTP المطابق والمرتبط بالتواصل والموقع والحملة.

    stringالتحقق: UUID أو معرّف مورد موثّق.

    الطلب

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

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

    stringالتحقق: 4–12 رقمًا.

    الطلب

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

    POST /api/white-label/portal/reseller/otp/:challengeId/verify
    http
    POST /api/white-label/portal/reseller/otp/11111111-1111-4111-8111-111111111111/verify HTTP/1.1
    Host: api.sparkglim.net
    Authorization: Bearer <EXISTING_SESSION_TOKEN>
    Content-Type: application/json
    
    {
      "code": "000000"
    }

    الاستجابة

    استجابة النجاح · HTTP 200
    json
    {
      "success": true,
      "data": {
        "id": "11111111-1111-4111-8111-111111111111",
        "status": "verified",
        "source": "sms_verification_codes"
      }
    }
    استجابة الخطأ · HTTP 400
    json
    {
      "success": false,
      "error": "<ERROR_MESSAGE>"
    }

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

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

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

    توافق المصدر

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

    • server/src/api/router.ts
    • server/src/api/routes/white-label.ts
    • server/src/white-label/reseller-service.ts
    • server/src/white-label/schemas.ts