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

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

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

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

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

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

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

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

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

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

Classic 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

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

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