نظرة عامة
الخطوة الأولى في دمج شحنات الهاتف المحمول هي جلب قائمة الخطط المتاحة من 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
التحقق من isEnabled
تحقق دائماً من
isEnabled قبل عرض الخطط. الخطط المعطلة قد تكون غير متاحة مؤقتاً بسبب مشاكل المشغل.إضافة هامش الربح
إضافة هامش الربح
احسب سعر البيع بإضافة هامش ربح معقول (عادةً 3-10%) إلى تكلفة الجملة.
فهرسة قاعدة البيانات
فهرسة قاعدة البيانات
أنشئ فهارس على الحقول التي يُستعلم عنها بتكرار (operator، code، isEnabled) للبحث السريع.
الخطوات التالية
الخطوة 2: التحقق من الصحة
تعلّم كيفية التحقق من أرقام الهاتف ومدخلات المستخدم
مرجع API الخطط
توثيق API الكامل لـ GET /v3/mobile/plans
API رصيد الحساب
تعلّم كيفية التحقق من رصيد حسابك
دليل التسعير
فهم تسعير API وهيكل التكاليف
صيغة الاستجابة
تعرّف على هياكل استجابة API
مرجع النماذج
اطلع على جميع نماذج البيانات والمخططات

