订阅

POST 
/autoenergy/subscriptions

为某个地址创建并激活订阅：校验地址、扣取激活费并开始委托能量。需要余额达到准入门槛（激活费 + 一次每日费 + 一笔 131k 档转账）。一个地址同一时间只能持有一个生效中的订阅，因此对生效中的地址而言该调用天然幂等——重复调用返回 409 address_busy。

计费

• 激活费立即扣取。每日费在激活 24 小时后首次扣取，之后每次距上一次扣费满 24 小时再扣；错过的周期不会补扣。
• 每笔被覆盖的转账按其能量档位（65k 或 131k）计费。
• 当某次每日费无法支付，或在一笔计费转账之后你的余额低于一次每日费 + 一笔 131k 档转账时，订阅会以 insufficient_balance 自动关闭。
• 如果套餐设置了 min_daily_tx，某个已完成的 24 小时周期内转账笔数不足时，会按 penalty_sun 扣取一次，记为 autoenergy_penalty。

当前金额请读取 GET /autoenergy/pricing。

请求

Responses

201

订阅已创建并激活。

400

insufficient_balance——余额不足以覆盖准入门槛。

403

reseller_suspended——你的账户已被暂停使用 AutoEnergy。未扣取任何费用。

409

address_busy——该地址已有一个生效中的订阅（你的，或其他账户的：若 GET /autoenergy/subscriptions/{address} 返回 404，说明由其他账户覆盖）；或 address_exists——你在该地址上有一个已关闭的订阅（请先重新激活或删除它）。

422

invalid_address（对象响应体，detail.error），或请求校验失败（数组响应体：detail 为字段错误列表——例如 idle_hours 超出 24–72、quota_max_tx 小于 1、expire_at 早于当前时间）。

500

internal_error——意外的服务端错误。重试前请先查看 GET /autoenergy/subscriptions/{address}。

502

fulfiller_unavailable——目前无法启动能量委托。未扣取任何费用；请稍后重试。

503

autoenergy_temporarily_unavailable 或 reseller_activation_balance_low——你的账户暂时无法使用 AutoEnergy。未扣取任何费用；请稍后重试。