生产 API
租赁选项
读取可用的 Energy 数量、租赁时长和当前是否接收新订单。
GET
/v1/energy/options本页内容
在渲染下单表单前调用此接口,或只做短时缓存。这些值由服务器控制,不能写死在客户端代码中。
响应 200
{"energy_per_portion":65000,"max_energy":1300000,"duration_hours":[1],"intake_enabled":true}
| 字段 | 类型 | 说明 |
|---|---|---|
energy_per_portion |
integer | 一份 Energy 的数量。 |
max_energy |
integer | 单笔订单允许的最大 Energy。 |
duration_hours |
integer[] | 可选租赁时长,单位为小时。 |
intake_enabled |
boolean | 接受新订单时为 true。 |
客户端校验
energy 必须为正数,不得大于 max_energy,且必须能被 energy_per_portion 整除。duration_hours 必须与响应中的一个值完全相同。
选项可能在本次读取和创建订单之间变化,因此服务器始终是最终依据。
错误
可能的状态为 401、429 和 503,均采用统一的错误格式。
Rentron