إدارة الشركات والمطوّرين باستخدام Edge

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

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

إنّ أحد العوامل الأساسية التي تحدّد ما إذا كنت بحاجة إلى إنشاء الشركات والمطوّرين يدويًا هو ما إذا كان المطوّرون سيحتاجون إلى بيانات اعتماد لتسجيل الدخول إلى واجهة المستخدم الخاصة بالإدارة، أو إرسال بيانات الاعتماد في طلبات البيانات إلى Edge management API، أو تسجيل الدخول إلى بوابة المطوّرين.

• إذا كان مطوّرو ميزة تحقيق الربح بحاجة إلى بيانات اعتماد تسجيل الدخول للوصول إلى واجهة مستخدم Edge أو واجهة برمجة التطبيقات، يجب أن يكون لديهم أولاً حساب مشرف Apigee.
• إذا كنت بحاجة إلى إنشاء حسابات لمطوّرين اختباريين لا يحتاجون إلى بيانات اعتماد (على سبيل المثال، إذا أردت إجراء طلبات بيانات من واجهة برمجة التطبيقات باستخدام حسابات لمطوّرين اختباريين وهميين)، لن تحتاج إلى حسابات Apigee.

إدارة مطوّري التطبيقات باستخدام واجهة المستخدم

يمكنك إنشاء حسابات مطوّري التطبيقات وإدارتها وتفعيلها باستخدام واجهة مستخدم Edge، كما هو موضّح في مقالة إدارة مطوّري التطبيقات. بعد إنشاء مطوّري التطبيقات، يمكنك إضافتهم إلى الشركات كما هو موضّح في الأقسام التالية.

إدارة الشركات باستخدام واجهة المستخدم

أنشئ الشركات واديرها وفعِّلها كما هو موضّح في الأقسام التالية.

استكشاف صفحة "الشركات"

انتقِل إلى صفحة "الشركات" كما هو موضّح أدناه.

إضافة شركة

لإضافة شركة:

1. الدخول إلى صفحة "الشركات"
2. انقر على + شركة.
3. أدخِل تفاصيل الشركة.

   وتشمل الحقول المطلوبة ما يلي:

   • اسم الشركة
   • المشرف (المستخدم الذي هو المشرف الأساسي للشركة)
   • نوع الفوترة

   استنادًا إلى إعدادات الفوترة لتحقيق الربح، قد يكون نوع الفوترة تلقائيًا هو PREPAID أو POSTPAID. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط أنواع الفوترة للدفع المسبق والدفع بعد انتهاء الخدمة باستخدام واجهة برمجة التطبيقات.

4. أضِف مطوّرًا واحدًا أو أكثر إلى الشركة.
   1. في قسم "المطوّرون"، أدخِل سلسلة في حقل إضافة مطوّر لعرض قائمة المطوّرين الذين يتطابقون مع السلسلة.
   2. اختَر مطوِّرًا من القائمة المنسدلة.
   3. كرِّر هذه الخطوات لإضافة مطوّرين آخرين إلى الشركة.
5. أضِف سمة مخصّصة واحدة أو أكثر.
   1. في قسم "السمات المخصّصة"، انقر على + جديدة.
   2. أدخِل اسم السمة المخصّصة وقيمتها.
   3. كرِّر الخطوات لإضافة سمات مخصّصة إضافية إلى الشركة.
6. انقر على إنشاء شركة.

تفعيل شركة وإيقافها

لتفعيل شركة وإيقافها:

1. الدخول إلى صفحة الشركة
2. ضَع المؤشر فوق الشركة التي تريد تفعيلها فعِّل في قائمة الإجراءات.
   أوقِف مفتاح التبديل لإيقاف الشركة.

تعديل شركة

لتعديل شركة:

1. الدخول إلى صفحة الشركة
2. ضَع المؤشر فوق الشركة التي تريد تعديلها وانقر على في قائمة الإجراءات.
3. عدِّل تفاصيل الشركة حسب الحاجة.
4. انقر على تعديل الشركة لحفظ التغييرات.

حذف شركة

لحذف شركة:

1. الدخول إلى صفحة "الشركات"
2. ضع المؤشر فوق الشركة التي تريد حذفها وانقر على في قائمة الإجراءات.
3. انقر على حذف لتأكيد عملية الحذف.

إدارة الشركات والمطوّرين باستخدام واجهة برمجة التطبيقات

يتم وصف استخدام واجهة برمجة التطبيقات لإدارة الشركات والمطوّرين في الأقسام التالية.

إنشاء الشركات والمطوّرين وتعديلها باستخدام واجهة برمجة التطبيقات

لإدارة الشركات والمطوّرين باستخدام واجهة برمجة التطبيقات Edge management API، يُرجى الرجوع إلى أقسام واجهة برمجة التطبيقات التالية:

• إنشاء شركة
• إنشاء حساب مطوِّر
  ملاحظة: يمكنك ضبط معلومات تحقيق الربح عند إنشاء حساب مطوِّر من خلال ضبط سمات مخصّصة.
• إضافة مطوّري الشركة أو تعديل بياناتهم
  ملاحظة: يمكنك اختياريًا منح المطوّر دورًا، ولكن هذا الإجراء ليس مطلوبًا. للحصول على قائمة بدوري المطوّرين، يُرجى الاطّلاع على مقالة استرداد أدوار المطوّرين.
• إدراج إعدادات تحقيق الربح لجميع المطوّرين أو لمطوّر واحد
  ملاحظة: يمكنك تحديد معلومات تحقيق الربح من خلال ضبط سمات مخصّصة عند إنشاء أو تعديل حساب مطوّر. يمكنك عرض السمات المخصّصة لتحقيق الربح التي تم ضبطها باستخدام واجهة برمجة التطبيقات العادية (غير المخصّصة لتحقيق الربح) لعرض جميع المطوّرين أو مطوّر واحد.

إدارة أدوار المطوّرين باستخدام واجهة برمجة التطبيقات

يمكنك إنشاء أدوار باستخدام واجهات برمجة التطبيقات لتحقيق الربح. يتيح لك ذلك تحديد أدوار لشركائك. على سبيل المثال، يمكنك إنشاء أدوار مشرف ومطوّر تطبيقات لشريك. ويمكن بعد ذلك إسناد هذه الأدوار إلى موظفي شركاء محدّدين.

إنشاء دور مطوِّر

لإنشاء دور مطوّر، أرسِل طلب POST إلى organizations/{org_name}/developer-roles. عند تقديم الطلب، عليك تحديد اسم الدور ووصفه وتحديد هوية المؤسسة في محتوى الطلب. على سبيل المثال:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}"
   }
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

استرداد أدوار المطوّرين

لاسترداد أدوار المطوّرين، أرسِل طلب GET إلى organizations/{org_id}/developer-roles. على سبيل المثال:

$ curl -H "Accept:application/json" -X GET \
"https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

من المفترض أن يظهر الردّ على النحو التالي (يتم عرض جزء من الردّ فقط):

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

إعدادات ضبط دور المطوّر لواجهة برمجة التطبيقات

يتم عرض خيارات ضبط دور المطوّر التالية في واجهة برمجة التطبيقات:

استرداد معدّل الضريبة لمطوّر باستخدام واجهة برمجة التطبيقات

يمكنك الحصول على معدّل الضريبة الحالي للمطوّر من خلال إرسال طلب GET إلى organizations/{org_name}/tax-engine. عند تقديم الطلب، عليك تحديد معرّف المطوّر كمَعلمة طلب بحث. على سبيل المثال:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

من المفترض أن يظهر الردّ على النحو التالي:

0.09

تنفيذ مهام أخرى خاصة بالمطوّرين باستخدام واجهة برمجة التطبيقات

يمكنك أيضًا تنفيذ العديد من المهام المتعلّقة بتحقيق الربح التي يمكنك تنفيذها لمؤسّسة، مثل إنشاء خطط الأسعار أو إنشاء شروط الإشعارات، لمطوّر individual فردي. على سبيل المثال، يمكنك إنشاء حساب مصرفي لمطوّر معيّن أو إنشاء تقرير أرباح لمطوّر معيّن.

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