<ph type="x-smartling-placeholder"></ph>
您正在查看 Apigee Edge 文档。
转到
Apigee X 文档。 信息
如果您有现有开发者需要迁移到创收功能,请执行以下操作:
- 为您所负责的开发者创建 API 产品、API 套餐和费率方案
(如果尚不存在)如需了解详情,请参阅:
<ph type="x-smartling-placeholder">
- </ph>
- 管理 API 产品
- 管理 API 商品套装
- 管理费率方案
- 发布价格方案,如发布价格方案中所述。
- 按照注册应用开发者中的说明,向您的组织添加新的开发者。
- 按照管理预付款账号中的说明为每位开发者充值预付款余额 余额。
- 按照购买率中所述,接受费率方案
来制定计划
注意:要免除设置费用,如果系统已向开发者收取了费用,请设置
waivefees
查询参数添加到true
。 - 如果您要迁移的开发者已有事务,
您可以使用以下资源手动转移事务用量:
/organizations/{org_name}/transactions
,其中{org_name}
是 组织的名称。注意:如果开发者没有现有交易,您可以跳过此步骤 操作。
transactions
资源会插入一个反映 当前事务使用情况,并更新所有内部计数器以反映此新值。例如,如果开发者在迁移前已向 API 发出了 1000 次调用, 捕获当前活动,您可以调用
transactions
资源,并将batchSize
属性设置为 1,000, 请求正文。下表总结了您可以在 请求正文来手动设置事务数、默认值以及是否 并非必需。
属性 说明 默认 是否必需? application
开发者应用的 ID。
不适用 是 batchSize
您要转移的交易次数。
1 否 custAttn
与 batchSize 一起使用的自定义属性的值,以计算 事务用途。
消息中的自定义属性编号必须指定为正整数 或小数(最多四位小数)值。不允许使用负值。
自定义属性必须在以下位置定义:
- API 产品的交易记录政策。请参阅配置 交易记录政策。
- API 产品的有效费率方案。请参阅配置 包含自定义属性的费率方案。
不适用 是 product
API 产品的 ID。
不适用 是 type
必须设置为
CHARGE
(这是默认值)。CHARGE
否 要跳过验证步骤并强制设置交易次数,请将 将
force
查询参数设置为true
(例如,?force=true
)。默认情况下,?force=false
和验证步骤为 。例如,如果预付费开发者的账号余额为零,且账号活动有误 已暂停,如果?force=false
,则验证期间请求失败。例如,以下请求将指定的 应用和 API 产品:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "application":{ "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b" }, "product":{ "id":"testproduct" }, "batchSize":50 }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:password
以下请求将指定应用的事务使用设置为 12.5,并且 API 产品。在请求中,
batchSize
设置为125
,值 设置为0.1
。时间 则 125 * 0.1 等于 12.5。$ curl -H "Content-Type:application/json" -X POST -d \ '{ "application":{ "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b" }, "product":{ "id":"testproduct" }, "batchSize": 125, "custAtt1" : 0.1 }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:password
- 如果未向开发者收取必要的设置费用或经常性费用,您可以手动
使用以下资源为费率方案收取设置费用或周期性费用:
/organizations/{org_name}/transactions
,其中{org_name}
是 组织的名称。注意:如果开发者已支付设置费用或经常性费用,您可以 请跳过此步骤。调用
transactions
资源不会影响设置或 费率方案定义的周期性费用。下表总结了您可以在 请求正文手动收取费率方案的设置费用或周期性费用,这是其默认设置 以及它们是否是必需值。
属性 说明 默认 是否必需? currency
价格方案使用的币种。为货币指定 ISO 4217 代码,例如 usd 表示美元,chf 表示瑞士法郎。
不适用 是 developer
开发者的 ID。
不适用 是 rate
设置费用或定期收费。
不适用 是 ratePlan
费率方案的 ID。
不适用 是 type
设为
SETUPFEES
或RECURRINGFEES
。CHARGE
是 如需跳过验证步骤并强制收取费用,请设置
force
查询true
的参数(例如?force=true
)。默认情况下 执行?force=false
和验证步骤。例如,如果预付费的 如果开发者的余额为零,且账号中的活动记录已被中止,?force=false
:请求在验证期间将失败。例如,以下请求向 开发者订阅了价格方案:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "developer":{ "id":"dev1@myorg.com" }, "currency":{ "id":"usd" }, "ratePlan":{ "id":"mypackage_rateplan1" }, "rate":10, "type":"SETUPFEES" }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:password