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

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

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

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

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

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

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

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

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

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

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

1. انقر على نشر (Publish) > الشركات (Companies) في شريط التنقّل العلوي.
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

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

احذف فئة مطوّر من خلال إرسال طلب DELETE إلى /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

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

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