مرجع API

التحقق من الخصم

يتحقق من خصم حملة قائم عبر العقد المشترك؛ ويعيد الشراء التحقق من السعر النهائي والأهلية.

POSThttps://api.sparkglim.net/api/public/discounts/validate

نموذج الوصول

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

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

افتح رابط الدفع المعاد؛ ويتحكم SparkGlim Server في الأسعار والوسائل والتحقق والتنفيذ، والعودة مجرد تنقل.

الطلب

الاسم	النوع	التحقق من المدخلات
`code`مطلوب اعتماد المورد أو رمز التحقق المطلوب للمسار؛ لا تنشر OTP حقيقيًا أو سر تذكرة.	`string`	التحقق: خصم موجود للحملة.
`campaign_id`مطلوب سجل حملة قائم ضمن حساب الطالب وأي نطاق أضيق لمفتاح الحملة.	`string`	التحقق: معرّف الحملة.
`phone_number`اختياري هاتف المشارك؛ وقد تتطلب وسائل الدفع وقواعد الحملة رقمًا دوليًا صحيحًا.	`string`	التحقق: هاتف العميل.
`email`اختياري بريد تواصل يستخدمه المسار المهيأ؛ ولا يمنح وحده صلاحية الوصول.	`string`	التحقق: عنوان بريد إلكتروني.

الطلب

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

POST /api/public/discounts/validate

http

POST /api/public/discounts/validate HTTP/1.1
Host: api.sparkglim.net
Content-Type: application/json

{
  "code": "<EXISTING_DISCOUNT>",
  "campaign_id": "11111111-1111-4111-8111-111111111111"
}

الاستجابة

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

json

{
  "success": true,
  "discount": {
    "id": "11111111-1111-4111-8111-111111111111",
    "code": "<EXISTING_DISCOUNT>",
    "name": "Example discount",
    "discount_percent": 10,
    "campaign_id": "11111111-1111-4111-8111-111111111111"
  }
}

استجابة الخطأ · HTTP 400

json

{
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

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

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

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

توافق المصدر

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

server/src/api/routes/public.ts
app/api/discounts/validate/route.ts

نموذج الوصول

الطلب

الطلب

الاستجابة

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

توافق المصدر

تابع التطوير