<ph type="x-smartling-placeholder"></ph>
您正在查看 Apigee Edge 文档。
转到
Apigee X 文档。 信息
如果您想更好地控制参与您的变现模式的公司和开发者, API 计划。 测试目的,您可以使用管理界面手动创建公司和开发者 和 API。
确定您是否需要手动创建公司和开发者时的一个主要考虑因素是 开发者是否需要凭据来登录管理界面、发送 或登录开发者门户。
- 如果您的变现开发者需要使用登录凭据才能访问 Edge 界面或 API,他们必须先拥有自己的登录凭据。 Apigee 管理员账号。
- 如果您只需创建不需要凭据的测试开发者(例如, 您想与虚构的测试开发者进行 API 调用), 必填字段。
使用界面管理应用开发者
按照管理应用开发者中的说明,使用 Edge 界面创建、管理和激活应用开发者。 创建应用开发者后,您可以将他们添加到公司,如以下部分所述。
使用界面管理公司
按照以下部分中的说明创建、管理和激活公司。
浏览“公司”页面
访问“公司”页面(如下所述)。
Edge
如需使用 Edge 界面访问“公司”页面,请执行以下操作:
- 登录 apigee.com/edge。
- 选择发布 >创收 >公司。
此时会显示“公司”页面。
如图所示,您可以通过“Companies”(公司)页面执行以下操作:
传统 Edge(私有云)
如需使用传统版 Edge 界面访问“公司”页面,请执行以下操作:
- 登录
http://ms-ip:9000
,其中 ms-ip 是管理服务器节点的 IP 地址或 DNS 名称。 - 选择发布 >公司。
此时会显示“公司”页面。
- 查看当前的公司列表
- 管理公司。具体而言,您可以添加、激活、修改和删除公司。
- 查看关联的开发者门户(仅限 Drupal 7)
添加公司
要添加公司,请执行以下操作:
- 访问“公司”页面。
- 点击 + 公司。
- 输入公司详细信息。
必填字段包括:
- 公司名称
- 管理员(主要公司的用户 管理员)
- 结算类型
根据创收结算配置,结算类型可能默认为
PREPAID
或POSTPAID
。如需了解详情,请参阅使用 API 配置预付款和后付费结算类型。 - 向公司添加一位或多位开发者。
- 在“开发者”部分的添加开发者字段中输入一个字符串,以显示与该字符串匹配的开发者列表。
- 从下拉列表中选择开发者。
- 重复执行此操作,将其他开发者添加到公司。
- 添加一个或多个自定义属性。
- 在“自定义属性”部分中,点击 + 新建。
- 输入自定义属性的名称和值。
- 重复操作,将其他自定义属性添加到公司。
- 点击创建公司。
激活和停用公司
要激活和停用公司,请执行以下操作:
- 访问“公司”页面。
- 将光标悬停在要启用的公司上方,然后在操作菜单中启用 。
停用切换开关即可停用该公司。
修改公司
要修改公司,请按以下步骤操作:
- 访问“公司”页面。
- 将光标悬停在要修改的公司上,然后点击操作菜单中的 。
- 根据需要更新公司详细信息。
- 点击更新公司以保存更改。
删除公司
要删除公司,请执行以下操作:
- 访问“公司”页面。
- 将光标悬停在要删除的公司上,然后点击操作菜单中的 。
- 点击删除以确认删除操作。
管理使用 API 的公司和开发者
以下各部分介绍了如何使用该 API 管理公司和开发者。
使用该 API 创建和更新公司及开发者
要使用 API Edge Management API 管理公司和开发者,请参阅以下 API 部分:
- 创建公司
- 创建开发者
注意:在创建开发者时,请通过传递自定义属性来配置创收信息。 - 将
更新公司开发者信息
注意:您也可以选择为开发者分配角色,但这不是必须的。要获取 开发者角色,请参阅检索开发者角色。 - 列出所有开发者或单个开发者的创收配置
注意:指定创收信息时,请传递自定义属性, 创建或 更新开发者。 您可以查看使用标准(非创收)API 设置的创收自定义属性,以便列出 所有开发者或 单个开发者。
使用 API 管理开发者角色
您可以使用变现 API 创建角色。这样,您就可以为您的 合作伙伴。例如,您可以为应用建立管理员和应用程序开发者角色, 合作伙伴。然后,您可以将这些角色分配给特定的合作伙伴员工。
创建开发者角色
如需创建开发者角色,请向以下账号发出 POST 请求:
organizations/{org_name}/developer-roles
。提出请求时,您需要
在请求正文中指定角色的名称和说明以及
组织。例如:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "name": "appDeveloper", "description": "App Developer", "organization": { "id": "{org_name}" } }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \ -u email:password
检索开发者角色
如需检索开发者角色,请向 organizations/{org_id}/developer-roles 发出 GET 请求。 例如:
$ curl -H "Accept:application/json" -X GET \ "https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \ -u email:password
响应应类似如下所示(仅显示部分响应):
{ "description" : "App Developer", "id" : "appdeveloper", "name" : "appDeveloper", "organization" : { ... } }
API 的开发者角色配置设置
以下开发者角色配置选项可供 API 使用:
名称 | 说明 | 默认 | 是否必需? |
---|---|---|---|
name |
开发者角色的名称。 |
不适用 | 是 |
description |
开发者角色的说明。 |
不适用 | 是 |
使用 API 检索开发者的税率
您可以向
organizations/{org_name}/tax-engine
。在发出请求时,您需要指定
以查询参数的形式标识开发者。例如:
$ curl -H "Accept:application/json" -X GET \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \ -u email:password
应返回如下所示的内容:
0.09
使用 API 执行其他特定于开发者的任务
您可以为组织执行的许多与创收相关的任务,例如 创建费率方案或创建通知条件,也可以对单个 开发者。例如,您可以为特定开发者创建银行账户,或生成 特定开发者的收入报告
下表列出了开发者特定任务,您可以使用 变现 API。该表格还列出了您可以在何处找到有关执行 这些任务。
任务 | 查找说明在哪里 |
---|---|
查看开发者接受的条款及条件 | |
查看开发者接受的 API 软件包 | |
创建开发者费率方案 | |
查看开发者可采用的费率方案 | |
查看适用于特定开发者且包含特定 产品 | |
仅查看已接受的开发者费率方案 | |
向开发者发放赠送金额 | |
为开发者设置信用额度 | |
查看开发者信用额度 | |
“充值”开发者的预付款余额(充值金额) | |
查看开发者的预付款余额 | |
为开发者设置通知条件 | |
为开发者创建和查看报告定义 |