管理開發人員類別

您目前查看的是 Apigee Edge 說明文件。
參閱 Apigee X說明文件。 資訊

開發人員類別是指具有相似特徵的開發人員或公司，您可以根據該類別設定營利功能。舉例來說，如要製定費率方案，並提供給所有開發收益分潤應用程式的開發人員，您可以建立名為「revenue_sharing」的開發人員類別，並新增開發人員。如要進一步瞭解如何建立含有開發人員類別的費率方案，請參閱「建立費率方案」。

探索「開發人員類別」頁面

使用 Edge UI 或 Edge 傳統版 UI 存取「開發人員類別」頁面，詳情請參閱下文。

新增開發人員類別

如何使用使用者介面新增開發人員類別：

1. 前往「開發類別」頁面。
2. 按一下「+ 開發人員類別」。
3. 輸入新類別的名稱和簡短說明。
4. 按一下「建立開發人員類別」。

將公司新增至開發人員類別

將公司新增至開發人員類別。一家公司只能屬於一個開發人員類別。

如何將公司新增至開發人員類別：

1. 依序選取頂端導覽列中的「發布」>「公司」。
2. 選取要新增至開發人員類別的公司。
3. 按一下公司頁面上的「編輯」。
4. 選取公司的開發人員類別。
5. 按一下 [儲存]。
   

編輯開發人員類別

如何使用 UI 編輯開發人員類別：

1. 前往「開發類別」頁面。
2. 將游標懸停在要編輯的開發人員類別上，然後按一下 。
3. 輸入開發人員類別。
4. 按一下「更新開發人員類別」。

刪除開發人員類別

如何使用使用者介面刪除開發人員類別：

1. 前往「開發類別」頁面。
2. 將遊標懸停在要編輯的開發人員類別上。
3. 按一下「」。
4. 按一下「刪除」確認操作。

使用 API 管理開發人員類別

按照下列各節所述，使用 API 管理開發人員類別。

使用 API 新增開發人員類別

向 /mint/organizations/{org_name}/developer-categories 發出 POST 要求，即可新增開發人員類別。

發出要求時，您會在酬載中指定類別 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"
}

使用 API 將開發人員或公司新增至開發人員類別

如要將開發人員或公司新增至開發人員類別，請分別向下列資源發出 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 指定為屬性，並將類別內部 ID 設為值。舉例來說，以下要求會將現有的開發人員新增至名為「Gold」的開發人員類別，該類別的 ID 為 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

使用 API 查看開發人員類別

查看機構中的特定開發人員類別或所有開發人員類別。

如要查看特定開發人員類別，請對 /mint/organizations/{org_name}/developer-categories/{category_id} 發出 GET 要求，其中 {category_id} 是開發人員類別的身分 (當您新增開發人員類別時，系統會在回應中傳回這組 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

向 /mint/organizations/{org_id}/developer-categories 發出 GET 要求，即可查看機構的所有 API 開發人員類別。例如：

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

使用 API 編輯開發人員類別

如要編輯開發人員類別，請向 /mint/organizations/{org_name}/developer-categories/{category_id} 發出 PUT 要求，其中 {category_id} 是需要更新的類別 ID。您必須在要求主體中指定更新的設定和開發人員類別 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

使用 API 刪除開發人員類別

請向 /mint/organizations/{org_name}/developer-categories/{category_id} 發出 DELETE 要求，藉此刪除開發人員類別，其中 {category_id} 是所要刪除的開發人員類別 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

API 的開發人員類別設定屬性

下表列出可使用 API 設定的設定屬性。

名稱	說明	預設	必填與否
name	房源名稱。設為 MINT_DEVELOPER_CATEGORY。	不適用	是
value	開發人員所屬開發人員類別的 ID。	不適用	是，這樣才能設定開發人員類別。