Skip to main content

نظرة عامة

الخطوة الأولى في دمج شحنات الهاتف المحمول هي جلب قائمة الخطط المتاحة من API. تشمل الخطط جميع مشغلي الشبكات (Mobilis، Djezzy، Ooredoo، Pixx) مع خيارات المبالغ الديناميكية والثابتة.
الخطط مستقرة ونادراً ما تتغير. احفظها في قاعدة بياناتك لتقليل استدعاءات API وتحسين الأداء.

مرجع API

اطلع على توثيق API الكامل لـ endpoint GET /v3/mobile/plans

فهم أنواع الخطط

الخطط الديناميكية

تتيح الخطط الديناميكية مبالغ متغيرة ضمن نطاق min/max:
حالات الاستخدام:
  • شحن الخطوط المدفوعة مسبقاً (رصيد)
  • دفع فواتير الخطوط المؤجلة (facture)
  • رصيد المكالمات الدولية

الخطط الثابتة

الخطط الثابتة لها مبالغ محددة مسبقاً:
حالات الاستخدام:
  • العروض الترويجية الخاصة
  • باقات الإنترنت
  • تفعيل الخدمات

خطط GetMenu

خطط خاصة تسترجع العروض المتاحة لرقم هاتف محدد:
تُعيد: مصفوفة suggested_offers تحتوي على جميع الخطط المتاحة لذلك الرقم تحديداً.

جلب الخطط من API

طلب أساسي

بنية الاستجابة

فهم حقل Cost

يمثل حقل cost معامل سعر الجملة الخاص بك:
مثال: cost = 0.98لشحن بقيمة 1000 دج:
  • القيمة الاسمية: 1000 دج (ما يستلمه المستخدم)
  • تكلفتك: 1000 × 0.98 = 980 دج (ما تدفعه)
  • هامش ربحك: 1000 - 980 = 20 دج (2%)

تخزين الخطط في قاعدة البيانات

بما أن الخطط نادراً ما تتغير، احفظها محلياً مع أسعارك الخاصة:

مخطط قاعدة البيانات

دالة المزامنة

عرض الخطط للمستخدمين

عند طلب المستخدمين للخطط، قدّمها من قاعدة بياناتك مع أسعارك الخاصة:

تصفية الخطط

حسب المشغل

حسب رقم الهاتف

أفضل الممارسات

احرص دائماً على تخزين الخطط في قاعدة بياناتك. الخطط نادراً ما تتغير، والتخزين المؤقت يحسّن الأداء بشكل ملحوظ.
لا تكشف أبداً عن حقل cost للمستخدمين النهائيين. اعرض فقط أسعار التجزئة الخاصة بك.
أنشئ مهمة cron يومية لمزامنة الخطط. هذا يضمن حصولك على أحدث العروض والتوافر.
تحقق دائماً من isEnabled قبل عرض الخطط. الخطط المعطلة قد تكون غير متاحة مؤقتاً بسبب مشاكل المشغل.
احسب سعر البيع بإضافة هامش ربح معقول (عادةً 3-10%) إلى تكلفة الجملة.
أنشئ فهارس على الحقول التي يُستعلم عنها بتكرار (operator، code، isEnabled) للبحث السريع.

الخطوات التالية

الخطوة 2: التحقق من الصحة

تعلّم كيفية التحقق من أرقام الهاتف ومدخلات المستخدم

مرجع API الخطط

توثيق API الكامل لـ GET /v3/mobile/plans

API رصيد الحساب

تعلّم كيفية التحقق من رصيد حسابك

دليل التسعير

فهم تسعير API وهيكل التكاليف

صيغة الاستجابة

تعرّف على هياكل استجابة API

مرجع النماذج

اطلع على جميع نماذج البيانات والمخططات