开发者文档

API 工作区
https://api.rentron.xyz/v1
OpenAPI 架构

选项

// GET

生产 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 必须与响应中的一个值完全相同。

选项可能在本次读取和创建订单之间变化,因此服务器始终是最终依据。

错误

可能的状态为 401429503,均采用统一的错误格式