مرجع API
التحقق من تحدي الرمز
يتحقق من تحدٍّ غير منتهٍ تابع لحساب الموزع المصرح ويؤشر ذلك التحدي وحده كموثق.
https://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/11111111-1111-4111-8111-111111111111/verify HTTP/1.1
Host: api.sparkglim.net
Authorization: Bearer <EXISTING_SESSION_TOKEN>
Content-Type: application/json
{
"code": "000000"
}الاستجابة
{
"success": true,
"data": {
"id": "11111111-1111-4111-8111-111111111111",
"status": "verified",
"source": "sms_verification_codes"
}
}{
"success": false,
"error": "<ERROR_MESSAGE>"
}تستخدم أخطاء التحقق والصلاحيات والموارد والأعطال حالة HTTP وبنية الخطأ الخاصة بالمعالج.
الحدود وإعادة المحاولة
الحد الافتراضي: 100 طلب لكل عنوان IP خلال 60 ثانية، مع ضوابط إضافية حسب المورد.
توافق المصدر
تتطلب العمليات المصرح بها اختبارًا خاصًا بالحساب.
server/src/api/router.tsserver/src/api/routes/white-label.tsserver/src/white-label/reseller-service.tsserver/src/white-label/schemas.ts