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

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

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

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

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

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

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

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

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

لإنشاء دور مطوِّر، عليك إصدار طلب 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" : {
   ...
  }
}

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

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

الاسم	الوصف	تلقائي	مطلوب؟
name	اسم دور المطوّر.	لا ينطبق	نعم
description	تمثّل هذه السمة وصفًا لدور مطوّر البرامج.	لا ينطبق	نعم

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

يمكنك معرفة معدّل الضريبة الحالي للمطوِّر من خلال إصدار طلب 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

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

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

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

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