الانتقال إلى المحتوى الرئيسي
GET
/
v3
/
mobile
/
plans
قائمة خطط الهاتف المحمول
curl --request GET \
  --url https://api.oneclickdz.com/v3/mobile/plans \
  --header 'X-Access-Token: <api-key>'

​
نظرة عامة

يُرجع قائمة شاملة بجميع خطط شحن الهاتف المحمول المتاحة لمشغّلي Mobilis وDjezzy وOoredoo.
الخطط مستقرة ونادرًا ما تتغير. آمن لتخزينها مؤقتًا في قاعدة بياناتك مع أسعارك الخاصة.

​
أنواع الخطط

خطط بمبالغ متغيرة حيث تحدد المبلغ ضمن نطاق معين. أمثلة: Prépayé، Postpayé (Facture)، الدولي الحقول المطلوبة: - plan_code - MSSIDN (رقم الهاتف) - amount (بين min_amount وmax_amount)

​
الاستجابة

​
success
boolean
مطلوب
يشير إلى نجاح الطلب
​
data
object
مطلوب
​
meta
object
مطلوب

​
الأمثلة

curl https://api.oneclickdz.com/v3/mobile/plans \
  -H "X-Access-Token: YOUR_API_KEY"

​
مثال على الاستجابة

{
  "success": true,
  "data": {
    "dynamicPlans": [
      {
        "code": "PREPAID_DJEZZY",
        "name": "📱 PREPAID | عادي",
        "operator": "Djezzy",
        "cost": 0.9925,
        "isEnabled": true,
        "min_amount": 100,
        "max_amount": 10000
      },
      {
        "code": "PREPAID_MOBILIS",
        "name": "📱 PREPAID | عادي",
        "operator": "Mobilis",
        "cost": 0.96,
        "isEnabled": true,
        "min_amount": 40,
        "max_amount": 3999
      }
    ],
    "fixedPlans": [
      {
        "code": "MIX50_DJEZZY",
        "name": "📱🌐 Auto | MIX 50",
        "operator": "Djezzy",
        "isEnabled": true,
        "cost": 0.9925,
        "amount": 50
      },
      {
        "code": "MIX1000_OOREDOO",
        "name": "📱🌐 AUTO | MIX 1000",
        "operator": "Ooredoo",
        "isEnabled": true,
        "cost": 0.99,
        "amount": 1000
      }
    ]
  },
  "meta": {
    "timestamp": "2025-10-29T00:35:59.220Z"
  }
}

​
شرح خصائص الخطط

الحقل cost هو مضاعف سعر الجملة الخاص بك:
  • 0.98 = تدفع 98% من القيمة الاسمية
  • لشحن 1000 دينار: تكلفتك = 1000 × 0.98 = 980 دينار
  • هامش ربحك: 1000 - 980 = 20 دينار (2%)
مهم: احذف cost من الاستجابات للمستخدمين النهائيين. طبّق هامش الربح الخاص بك.
الخطط الديناميكية لها min_amount وmax_amount: - يمكن للمستخدمين اختيار أي مبلغ ضمن هذا النطاق - النطاق الشائع: 50 - 5000 دينار - بعض المشغّلين يسمحون بحتى 10,000 دينار الخطط الثابتة لها amount واحد: - لا يلزم اختيار مبلغ
  • تفعيل الخدمة مباشرة - شائع للعروض الخاصة وحزم البيانات
الحقل isEnabled يشير إلى:
  • true: الخطة متاحة للاستخدام
  • false: معطّلة مؤقتًا (صيانة، مشكلات المشغّل)
تحقق دائمًا من هذا الحقل قبل السماح للمستخدمين باختيار خطة.

​
استراتيجية التكامل

1

التحميل الأولي

استدعِ هذا endpoint مرة واحدة عند بدء تشغيل تطبيقك أو أثناء الإعداد
2

تخزين الخطط

احفظ الخطط في قاعدة بياناتك مع أسعارك الخاصة
CREATE TABLE mobile_plans (
  code VARCHAR PRIMARY KEY,
  name VARCHAR,
  operator VARCHAR,
  our_cost DECIMAL,
  sell_price DECIMAL,
  min_amount INT,
  max_amount INT,
  amount INT,
  is_enabled BOOLEAN,
  updated_at TIMESTAMP
);
3

تطبيق هامش الربح

احسب سعر البيع الخاص بك:
const ourCost = faceValue * plan.cost;
const markup = 0.05; // 5% profit
const sellPrice = ourCost * (1 + markup);
4

خدمة المستخدمين

اعرض الخطط مع أسعارك للمستخدمين النهائيين
{
  code: plan.code,
  name: plan.name,
  operator: plan.operator,
  price: sellPrice,
  minAmount: plan.min_amount,
  maxAmount: plan.max_amount
}
5

المزامنة الدورية

زامن الخطط يوميًا أو عند إشعار بالتغييرات
// Daily sync at midnight
cron.schedule('0 0 * * *', syncPlans);

​
تصفية الخطط

const mobilisPlans = [
  ...data.dynamicPlans.filter((p) => p.operator === "Mobilis"),
  ...data.fixedPlans.filter((p) => p.operator === "Mobilis")
];
const djezzyPlans = [
  ...data.dynamicPlans.filter((p) => p.operator === "Djezzy"),
  ...data.fixedPlans.filter((p) => p.operator === "Djezzy")
];

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

تخزين الخطط مؤقتًا

خزّن الخطط في قاعدة بياناتك لتقليل استدعاءات API وتحسين الأداء

إخفاء التكلفة

لا تكشف أبدًا عن cost الجملة للمستخدمين النهائيين. اعرض فقط أسعار التجزئة الخاصة بك

التحقق من isEnabled

تحقق دائمًا من isEnabled قبل عرض الخطط للمستخدمين

المزامنة المنتظمة

نفّذ مزامنة يومية أو مستمعًا لـ webhook لتحديثات الخطط

​
Endpoints ذات الصلة

إرسال الشحن

إرسال شحن هاتف محمول باستخدام رمز الخطة

التحقق من الحالة

تتبع حالة الشحن