您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
開發人員類別是指具有類似特徵的一組開發人員或公司,方便您設定營利類別,以便在特定類別中運作。舉例來說,您可以建立費率方案,並適用於所有開發收益分潤應用程式的開發人員,方法是建立名為「revenue_sharing」的開發人員類別,然後新增該類別的開發人員。如要進一步瞭解如何使用開發人員類別建立費率方案,請參閱「建立費率方案」。
探索開發人員類別頁面
透過 Edge UI 或傳統版 Edge UI 存取「開發人員類別」頁面,如以下各節所述。
Edge UI
如何存取「開發類別」頁面:
- 登入 apigee.com/edge。
- 在左側導覽列中,依序選取「發布」>「營利」>「開發人員類別」。
系統隨即會顯示「開發人員類別」頁面。
如上圖所示,在「開發人員類別」頁面上,您可以:
傳統邊緣 (Private Cloud)
如何透過傳統版 Edge UI 存取「開發類別」頁面:
- 登入
http://ms-ip:9000
,其中 ms-ip 是管理伺服器節點的 IP 位址或 DNS 名稱。 - 在頂端的導覽列中,依序選取「發布」>「開發人員類別」。
系統隨即會顯示「開發人員類別」頁面。
您可以透過「開發人員類別」頁面執行下列操作:
新增開發人員類別
如何使用使用者介面新增開發人員類別:
- 前往「開發類別」頁面。
- 按一下「+ 開發人員類別」。
- 輸入新類別的名稱和簡短說明。
- 按一下「Create Developer Category」。
將公司加入開發人員類別
將公司加入開發人員類別。每家公司只能屬於一個開發人員類別。
如何將公司加入開發人員類別:
- 在頂端導覽列中,依序選取「發布」>「公司」。
- 選取要加入開發人員類別的公司。
- 按一下公司頁面上的「編輯」。
- 選取公司的「開發人員類別」。
- 點按「儲存」。
編輯開發人員類別
如何使用 UI 編輯開發人員類別:
- 前往「開發類別」頁面。
- 將滑鼠遊標移到要編輯的開發人員類別上,然後按一下 。
- 輸入開發人員類別。
- 按一下「更新開發人員類別」。
刪除開發人員類別
如何使用 UI 刪除開發人員類別:
- 前往「開發類別」頁面。
- 將滑鼠遊標移到要編輯的開發人員類別上。
- 按一下「」。
- 按一下「刪除」來確認作業。
使用 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 指定為值。舉例來說,以下要求會將現有的開發人員加到名為「金級」類別 (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。 |
不適用 | 是,為了設定開發人員類別。 |