管理開發人員類別

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

開發人員類別是指具有類似特徵的開發人員或公司群組，可讓您設定該特定類別的營利方式。舉例來說，您可以建立適用於所有開發人員的費率方案，這些開發人員會開發應用程式以分享收益，方法是建立名為「revenue_sharing」的開發人員類別，然後將開發人員加入該類別。如要進一步瞭解如何建立含有開發人員類別的費率方案，請參閱「建立費率方案」。

瀏覽「開發人員類別」頁面

如要存取「開發人員類別」頁面，請使用 Edge UI 或傳統 Edge UI，詳情請參閱下列各節。

Edge UI

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

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

系統隨即會顯示「開發人員類別」頁面。

如圖所示，「開發人員類別」頁面可讓您執行下列操作：

傳統 Edge (Private Cloud)

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

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

系統隨即會顯示「開發人員類別」頁面。

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

新增開發人員類別

如要透過使用者介面新增開發人員類別，請按照下列步驟操作：

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

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

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

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

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

編輯開發人員類別

如要透過使用者介面編輯開發人員類別，請按照下列步驟操作：

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

刪除開發人員類別

如要使用 UI 刪除開發人員類別，請按照下列步驟操作：

  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

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

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。

 不適用 是，必須先完成驗證才能設定開發人員類別。