إدارة فئات مطوّري البرامج

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

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

استكشاف صفحة "فئات المطوّرين"

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

واجهة مستخدم Edge

للوصول إلى صفحة Develop Categories (فئات التطوير):

  1. سجِّل الدخول إلى apigee.com/edge.
  2. اختيار نشر > تحقيق الربح > فئات المطوّرين في شريط التنقّل الأيمن

وسيتم عرض صفحة "فئات المطوّرين".

وكما هو موضّح في الشكل، تتيح لك صفحة "فئات المطوّرين" إجراء ما يلي:

كلاسيكي Edge (السحابة الإلكترونية الخاصة)

للوصول إلى صفحة Develop Categories (فئات التطوير) باستخدام واجهة مستخدم Classic Edge:

  1. سجِّل الدخول إلى http://ms-ip:9000، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.
  2. اختَر نشر > فئات المطوّرين في شريط التنقّل العلوي.

وسيتم عرض صفحة "فئات المطوّرين".

تتيح لك صفحة "فئات المطوّرين" ما يلي:

إضافة فئة مطوِّر

لإضافة فئة مطوِّرين باستخدام واجهة المستخدِم:

  1. انتقِل إلى صفحة تطوير الفئات.
  2. انقر على + فئة المطوِّر.
  3. أدخل اسمًا للفئة الجديدة ووصفًا موجزًا.
  4. انقر على إنشاء فئة مطوِّر.

إضافة شركة إلى فئة المطوّرين

يُرجى إضافة شركة إلى فئة المطوّرين. يمكن أن تنتمي الشركة إلى فئة مطوّرين واحدة فقط.

لإضافة شركة إلى فئة مطوّرين، يُرجى اتّباع الخطوات التالية:

  1. اختَر نشر > الشركات في شريط التنقّل العلوي.
  2. اختَر الشركة التي تريد إضافتها إلى فئة المطوِّر.
  3. انقر على تعديل في صفحة الشركة.
  4. اختَر فئة المطوّر للشركة.
  5. انقر على حفظ.

تعديل فئة مطوِّر

لتعديل فئة مطوِّرين باستخدام واجهة المستخدِم:

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

حذف فئة مطوِّر

لحذف فئة مطوِّرين باستخدام واجهة المستخدِم:

  1. انتقِل إلى صفحة تطوير الفئات.
  2. ضع مؤشر الماوس فوق فئة المطوّر التي تريد تعديلها.
  3. انقر على
  4. انقر على حذف لتأكيد العملية.

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

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

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

أضِف فئة مطوِّرين من خلال إصدار طلب POST إلى "/mint/organizations/{org_name}/developer-categories".

عند إصدار الطلب، يمكنك تحديد الفئة name وdescription في الحمولة. مثال:

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Content-Type:application/json"  \
  -d '{
    "name": "Gold",
    "description": "Gold membership"
  }' \
  -u email:password

يجب أن يبدو الرد على النحو التالي:

{
  "description" : "Gold membership",
  "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0",
  "name" : "Gold"
}

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

يمكنك إضافة مطوّر أو شركة إلى فئة المطوّرين عند إضافة الشركة أو المطوّر أو تعديلهما من خلال إصدار طلب POST للموارد التالية، على التوالي:

  • /organizations/{org_name}/companies
  • /organizations/{org_name}/developers

لإضافة مطوّر أو شركة إلى فئة مطوّر برامج عند تعديل الشركة أو المطوّر، يمكنك إصدار طلب PUT إلى الموارد التالية، على التوالي:

  • /organizations/{org_name}/companies/{company_id}
  • /organizations/{org_name}/developers/{developer_id}

يمكن أن تنتمي الشركة أو المطوّر إلى فئة مطوِّرين واحدة فقط.

حدِّد MINT_DEVELOPER_CATEGORY كسمة في نص الطلب مع استخدام المعرّف الداخلي للفئة كقيمة. على سبيل المثال، يؤدي الطلب التالي إلى إضافة مطوّر حالي إلى فئة المطوّرين باسم "المستوى الذهبي"، والتي تحمل رقم التعريف aa6f960a-d9fd-416e-be39-c071418aabd0.

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/K4jW2QLjZ1h8GFA8" \
  -H "Content-Type: application/json" \
  -d '{
   "email" : "developer@apigee.com",
    "developerId" : "K4jW2QLjZ1h8GFA8",
    "firstName" : "Dev",
    "lastName" : "One",
    "userName" : "devone",    
    "attributes" : [ {
      "name" : "MINT_REGISTRATION_ID",
      "value" : "dev1"
    }, {
      "name" : "MINT_DEVELOPER_LEGAL_NAME",
      "value" : "DEV ONE"
    }, {
      "name" : "MINT_DEVELOPER_TYPE",
      "value" : "TRUSTED"
    }, {
      "name" : "MINT_BILLING_TYPE",
      "value" : "PREPAID"
    }, {
      "name" : "MINT_IS_BROKER",
      "value" : "TRUE"
    }, {
      "name" : "MINT_DEVELOPER_CATEGORY",
      "value" : "aa6f960a-d9fd-416e-be39-c071418aabd0"
    }, {
      "name" : "MINT_DEVELOPER_ADDRESS",
      "value" : "{
                   "address1": "Dev One Address",
                   "city": "Pleasanton",
                   "country": "US",
                   "isPrimary": "true",
                   "state": "CA",
                   "zip": "94588"
                }"
    }
  }' \
  -u email:password

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

عرض فئة معيّنة من المطوّرين أو جميع فئات المطوّرين في مؤسسة

يمكنك الاطّلاع على فئة معيّنة من المطوّرين من خلال إصدار طلب استرداد بيانات باستخدام GET إلى /mint/organizations/{org_name}/developer-categories/{category_id}، حيث يشير {category_id} إلى تعريف فئة المطوّر (يتم عرض رقم التعريف في الردّ عند إضافة فئة المطوّر). مثال:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

يمكنك الاطّلاع على جميع فئات مطوّري برامج واجهة برمجة التطبيقات لمؤسسة من خلال إصدار طلب GET إلى /mint/organizations/{org_id}/developer-categories. مثال:

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

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

يمكنك تعديل فئة مطوِّر برامج من خلال إصدار طلب PUT إلى /mint/organizations/{org_name}/developer-categories/{category_id}، حيث يشير {category_id} إلى تعريف الفئة المطلوب تعديلها. يجب أن تحدّد في نص الطلب الإعدادات المعدَّلة ورقم تعريف فئة المطوِّر. على سبيل المثال، يعدِّل الطلب التالي وصف فئة المطوِّر:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Content-Type: application/json"  \
  -d '{
    "id": "aa6f960a-d9fd-416e-be39-c071418aabd0",
    "description": "Premium membership"
  }' \
  -u email:password

حذف فئة مطوِّر باستخدام واجهة برمجة التطبيقات

يمكنك حذف إحدى فئات المطوّرين من خلال إصدار طلب "حذف" إلى /mint/organizations/{org_name}/developer-categories/{category_id}، حيث يشير {category_id} إلى تعريف فئة المطوِّرين المطلوب حذفها. على سبيل المثال:

curl -X DELETE "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

خصائص إعدادات فئة المطوِّرين لواجهة برمجة التطبيقات

يلخّص الجدول التالي خصائص الإعدادات التي يمكن ضبطها باستخدام واجهة برمجة التطبيقات.

الاسم الوصف تلقائي مطلوب؟
name

اسم الموقع. تم الضبط على MINT_دِر_CATEGORY.

لا ينطبق نعم
value

رقم تعريف فئة المطوّر التي تمت إضافة المطوّر إليها.

لا ينطبق نعم، من أجل ضبط فئة المطور.