为开发者改用创收功能

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

如果您有现有开发者需要迁移到创收功能，请执行以下操作：

  1. 为您所负责的开发者创建 API 产品、API 套餐和费率方案 （如果尚不存在）如需了解详情，请参阅： <ph type="x-smartling-placeholder">
  2. 发布价格方案，如发布价格方案中所述。
  3. 按照注册应用开发者中的说明，向您的组织添加新的开发者。
  4. 按照管理预付款账号中的说明为每位开发者充值预付款余额 余额。
  5. 按照购买率中所述，接受费率方案 来制定计划

    注意：要免除设置费用，如果系统已向开发者收取了费用，请设置 waivefees 查询参数添加到 true。

  6. 如果您要迁移的开发者已有事务， 您可以使用以下资源手动转移事务用量：
    /organizations/{org_name}/transactions，其中 {org_name} 是 组织的名称。

    注意：如果开发者没有现有交易，您可以跳过此步骤 操作。

    transactions 资源会插入一个反映 当前事务使用情况，并更新所有内部计数器以反映此新值。

    例如，如果开发者在迁移前已向 API 发出了 1000 次调用， 捕获当前活动，您可以调用 transactions 资源，并将 batchSize 属性设置为 1,000， 请求正文。

    下表总结了您可以在 请求正文来手动设置事务数、默认值以及是否 并非必需。

    属性 说明 默认 是否必需？
    application

    开发者应用的 ID。

    		 不适用 是
    batchSize

    您要转移的交易次数。

    		 1 否
    custAttn

    与 batchSize 一起使用的自定义属性的值，以计算 事务用途。

    消息中的自定义属性编号必须指定为正整数 或小数（最多四位小数）值。不允许使用负值。

    自定义属性必须在以下位置定义：

    		 不适用 是
    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
  7. 如果未向开发者收取必要的设置费用或经常性费用，您可以手动 使用以下资源为费率方案收取设置费用或周期性费用：
    /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