您目前查看的是 Apigee Edge 說明文件。
參閱 Apigee X 說明文件。 資訊
開發人員類別是指一組擁有類似特徵的開發人員或公司,可讓您針對該類別設定營利權限。舉例來說,您可以建立「revenue_sharing」開發人員類別並新增開發人員,藉此制定適用於所有開發收益分享應用程式的費率方案。如要進一步瞭解如何使用開發人員類別建立費率方案,請參閱「建立費率方案」。
探索開發人員類別頁面
如以下各節所述,您可以透過 Edge UI 或傳統 Edge UI 存取「開發人員類別」頁面。
邊緣 UI
若要存取「開發類別」頁面,請按照下列步驟進行:
- 登入 apigee.com/edge。
- 在左側導覽列中,依序選取「發布」>「營利」>「開發人員類別」。
系統隨即會顯示「開發人員類別」頁面。
如圖所示,「開發人員類別」頁面可讓您:
傳統版 Edge (Private Cloud)
如要使用傳統版 Edge UI 存取「開發類別」頁面,請按照下列步驟操作:
- 登入
http://ms-ip:9000
,其中 ms-ip 是管理伺服器節點的 IP 位址或 DNS 名稱。 - 在頂端的導覽列中依序選取「發布」>「開發人員類別」。
系統隨即會顯示「開發人員類別」頁面。
在「開發人員類別」頁面中,您可以執行下列操作:
新增開發人員類別
如何使用 UI 新增開發人員類別:
- 前往開發類別頁面。
- 按一下「+ 開發人員類別」。
- 輸入新類別的名稱和簡短說明。
- 按一下「建立開發人員類別」。
將公司加入開發人員類別
將公司新增至開發人員類別。公司只能屬於一個開發人員類別。
如何將公司新增至開發人員類別:
- 在頂端導覽列中依序選取「發布」>「公司」。
- 選取要加入開發人員類別的公司。
- 在公司頁面上按一下「編輯」。
- 選取該公司的「開發人員類別」。
- 按一下「儲存」。
編輯開發人員類別
如何使用 UI 編輯開發人員類別:
- 前往開發類別頁面。
- 將遊標懸停在您要編輯的開發人員類別上,然後按一下
。
- 輸入開發人員類別。
- 按一下「更新開發人員類別」。
刪除開發人員類別
如要透過 UI 刪除開發人員類別,請按照下列步驟操作:
- 前往開發類別頁面。
- 將遊標懸停在您要編輯的開發人員類別上。
- 按一下「
」。
- 按一下「Delete」(刪除) 來確認作業。
使用 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}/開發人員
如要在編輯公司或開發人員時將開發人員或公司新增至開發人員類別,請分別對下列資源發出 PUT 要求:
- /organizations/{org_name}/companies/{company_id}
- /organizations/{org_name}/developers/{developer_id}。
每家公司或開發人員只能屬於一個開發人員類別。
在要求主體中將 MINT_DEVELOPER_CATEGORY
指定為屬性,並使用類別內部 ID 做為值。舉例來說,以下要求會將現有開發人員加入名為「黃金」類別的「黃金」類別 (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。舉例來說,下列要求會編輯開發人員類別的說明:
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}
是要刪除的開發人員類別識別。例如:
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。 |
無 | 是,用於設定開發人員類別。 |