您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
开发者类别是一组具有类似特征的开发者或公司,您可以通过它们配置变现模式以针对该特定类别开展业务。例如,您可以创建适用于开发收益分成应用的开发者的费率方案,只需创建一个名为“revenue_sharing”的开发者类别并将开发者添加到该类别即可。如需详细了解如何根据开发者类别创建费率方案,请参阅创建费率方案。
探索“开发者类别”页面
使用 Edge 界面或传统版 Edge 界面访问“开发者类别”页面,如以下部分所述。
Edge 界面
如需访问“开发类别”页面,请按以下步骤操作:
- 登录 apigee.com/edge。
- 在左侧导航栏中,依次选择发布 > 创收 > 开发者类别。
此时会显示“开发者类别”页面。
如图所示,通过“开发者类别”页面,您可以:
传统 Edge (Private Cloud)
如需使用传统版 Edge 界面访问“开发类别”页面,请执行以下操作:
- 登录
http://ms-ip:9000
,其中 ms-ip 是管理服务器节点的 IP 地址或 DNS 名称。 - 在顶部导航栏中,依次选择发布 > 开发者类别。
此时会显示“开发者类别”页面。
在“开发者类别”页面上,您可以:
添加开发者类别
如需使用界面添加开发者类别,请执行以下操作:
- 访问“开发类别”页面。
- 点击 + 开发者类别。
- 输入新类别的名称和简短说明。
- 点击创建开发者类别。
将公司添加到开发者类别
将公司添加到开发者类别。一家公司只能属于一个开发者类别。
若要将公司添加到开发者类别,请按以下步骤操作:
- 在顶部导航栏中,依次选择发布 > 公司。
- 选择您要添加到开发者类别的公司。
- 点击公司页面上的 Edit(修改)。
- 选择该公司的开发者类别。
- 点击保存。
修改开发者类别
如需使用界面修改开发者类别,请执行以下操作:
- 访问“开发类别”页面。
- 将光标放在要修改的开发者类别上,然后点击 。
- 输入开发者类别。
- 点击更新开发者类别。
删除开发者类别
如需使用界面删除开发者类别,请执行以下操作:
- 访问“开发类别”页面。
- 将光标放在要修改的开发者类别上。
- 点击 。
- 点击删除以确认操作。
使用 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。 |
不适用 | 是,为了设置开发者类别。 |