مرجع API

تسجيل قرار مصرح

يسجل قرارًا مصرحًا على طلب موافقة قائم دون تجاوز إشراف SparkGlim.

POSThttps://api.sparkglim.net/api/white-label/portal/reseller/approval-requests/:requestId/decision

نموذج الوصول

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

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

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

الترويسات

الاسم	النوع	التحقق من المدخلات
`Authorization`مطلوب جلسة SparkGlim حاملة قائمة؛ وتحدد عضوية الحساب والصلاحيات المعينة السماح بكل عملية.	`string`	التحقق: رمز Bearer لجلسة مصادقة موجودة.

المعاملات

الاسم	النوع	التحقق من المدخلات
`requestId`مطلوب سجل علاقة أو مراجعة قائم ضمن الحساب؛ ويتحقق الخادم من الملكية والصلاحيات اللازمة.	`string`	التحقق: UUID أو معرّف مورد موثّق.

الطلب

الاسم	النوع	التحقق من المدخلات
`status`مطلوب الحالة المدعومة المطلوبة؛ وتتحكم قواعد الموافقة في النشر والوصول.	`enum`	التحقق: approved \| rejected \| changes_requested \| escalated \| cancelled.
`reason`اختياري شرح يحتفظ به مع سجل موافقة الحساب أو مراجعته.	`string\|null`	التحقق: <=2000.
`decisionPayload`اختياري تصنيف مورد مراجعة أو أدلة تحفظ لعملية موافقة الحساب والإشراف عليه.	`object`	التحقق: كائن JSON.

الطلب

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

POST /api/white-label/portal/reseller/approval-requests/:requestId/decision

http

POST /api/white-label/portal/reseller/approval-requests/11111111-1111-4111-8111-111111111111/decision HTTP/1.1
Host: api.sparkglim.net
Authorization: Bearer <EXISTING_SESSION_TOKEN>
Content-Type: application/json

{
  "status": "changes_requested",
  "reason": "Example review comment"
}

الاستجابة

استجابة النجاح · HTTP 200

json

{
  "success": true,
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "pending"
  }
}

استجابة الخطأ · 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

نموذج الوصول

الترويسات

المعاملات

الطلب

الطلب

الاستجابة

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

توافق المصدر

تابع التطوير