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

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

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

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

• إذا كان مطوّرو برامج تحقيق الربح بحاجة إلى بيانات اعتماد تسجيل الدخول للوصول إلى واجهة مستخدم أو واجهة برمجة تطبيقات 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. انقر على حذف لتأكيد عملية الحذف.

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

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

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

لإدارة الشركات والمطورين باستخدام واجهة برمجة التطبيقات API 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 إلى المؤسسات/{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

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

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

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