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

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

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

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

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

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

للوصول إلى صفحة "إنشاء الفئات":

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

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

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

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

للوصول إلى صفحة "إنشاء الفئات" باستخدام واجهة مستخدم 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_DEVELOPER_CATEGORY.

لا ينطبق نعم
value

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

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