الوثائق

4.الإشتراكات

ما هي الإشتراكات؟

الاشتراك Subscription هو عملية ربط تطبيقك بمنتج محدد. من خلال الاشتراك، تقرّ بالشروط والحدود المحددة لذلك المنتج وتتلقى بيانات الاعتماد (API keys) اللازمة لإجراء استدعاءات API.

يرتبط كل اشتراك بما يلي:

  • منتج (حزمة واجهات APIs التي تريد استخدامها)
  • تطبيق (تطبيقك المسجل في البوابة)

كيف تعمل الاشتراكات

  1. اختر منتجًا

    اختر منتج API يلبي احتياجاتك من صفحة المنتجات. ثم انقر على زر Subscribe لبدء دورة الاشتراك، وحدد خطة الأسعار (rate plan) وأكّد الاشتراك.

  2. الاشتراك عبر صفحة تفاصيل المنتج

    1. انقر على زر Subscribe وحدد خطة الأسعار، ثم وافق على الشروط والأحكام.
    2. انقر على نافذة التأكيد المنبثقة Confirm لتأكيد طلب الاشتراك.
    3. سيقوم المشرف Admin بمراجعة طلبك والموافقة عليه أو رفضه مع ذكر السبب.

    ملاحظة: إذا لم يكن المنتج متعلقًا بقطاعك، فلن تتمكن من الاشتراك فيه.

  3. أنشئ تطبيقًا جديدًا – اربط تطبيقك المسجل بالمنتج.
  4. احصل على بيانات الاعتماد – توفّر البوابة مفاتيح API.
  5. ابدأ باستهلاك واجهات APIs – استخدم هذه المفاتيح في طلبات API الخاصة بك.

إدارة الاشتراكات

  • يمكنك الاشتراك في عدة منتجات باستخدام التطبيق نفسه.
  • يمكن أن يحتوي كل اشتراك على مفتاح خاص به.
  • إذا انتهت صلاحية اشتراكك أو تم إلغاؤه، ستفشل طلبات API التي تستخدم ذلك المفتاح.
  • يمكنك الوصول إلى خططك بالنقر على Subscriptions من القائمة الرئيسية.
  • يمكنك إلغاء اشتراكك من صفحة Subscriptions بالنقر على زر Cancel Subscription.

الوصول إلى اشتراكات خطط الأسعار وإدارتها

  1. افتح صفحة Subscriptions من القائمة الرئيسية.

  2. يمكنك عرض مزيد من التفاصيل حول خطتك المشترَك بها بالنقر على زر View Details.
  3. ألغِ الاشتراك بالنقر على زر Cancel Subscription.

دورة الموافقة

ما هي دورة الموافقة؟

دورة الموافقة Approval Cycle هي العملية التي تستخدمها البوابة للتحقق من صحة اشتراكات المطورين والموافقة عليها. وفقًا للإعدادات، تتم مراجعة طلبك من قبل مشرف قبل منح حق الوصول. تضمن هذه الدورة اكتمال معلوماتك وصحتها للاشتراك على المنتج.

كيف تعمل الموافقة

  1. يقدّم المطور طلب اشتراك
    • اختر منتجًا.
    • اشترك في المنتج.
  2. ترسل البوابة طلب اشتراكك إلى المشرف للمراجعة
    • ستُخطر البوابة المشرف بالطلب.
    • سيُرسل إليك كذلك إشعار يتضمن رقم الطلب ومعلوماته.
  3. يراجع المشرف الطلب
    • يتحقق المشرف من استيفاء المطور للمتطلبات.
    • إما أن يوافق المشرف على الطلب أو يرفضه.
  4. إشعار المطور
    • Approved → ستتلقى بريدًا إلكترونيًا بالموافقة.
    • Rejected → ستتلقى إشعارًا يتضمن سبب الرفض.

أهمية دورة الموافقة

  • حماية واجهات APIs الحساسة.
  • المساعدة في إدارة الطلبات والوكلاء.
  • ضمان منح الوصول فقط للطلبات الموثقة.
  • دعم الالتزام بالمتطلبات التجارية والقانونية.