管理開發人員類別

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

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

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

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

Edge UI

如要存取「開發類別」頁面，請按照下列步驟操作：

  1. 登入 apigee.com/edge。
  2. 依序選取左側導覽列中的「發布」>「營利」>「開發人員類別」。

畫面上會顯示「開發人員類別」頁面。

如圖所示，「開發人員類別」頁面可讓您：

Classic Edge (Private Cloud)

如要使用 Edge 傳統版 UI 存取「開發類別」頁面，請按照下列步驟操作：

  1. 登入 http://ms-ip:9000，其中 ms-ip 是管理伺服器節點的 IP 位址或 DNS 名稱。
  2. 依序選取頂端導覽列中的「發布」>「開發人員類別」。

畫面上會顯示「開發人員類別」頁面。

開發人員類別頁面可讓您：

新增開發人員類別

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

  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 (在您新增開發人員類別時，系統會在回應中傳回該 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。

 無 是，為了設定開發人員類別。