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

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

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

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

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

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

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