生产 API
查询订单
读取一笔属于该账户的订单,并判断资源分配和完整租赁生命周期是否结束。
GET
/v1/energy/orders/{id}本页内容
使用创建订单时返回的 UUID,或使用其 Location 请求头中的路径。
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
id |
UUID | 公开订单标识符。 |
响应 200
{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"total_trx":"3.200000","status":"delivered","lifecycle_final":false,"delivery_final":true,"created_at":1784376000,"updated_at":1784376012,"failure":null}
| 字段 | 类型 | 说明 |
|---|---|---|
status |
string | created、executing、delivered、rental_finished、failed 或 rental_interrupted。 |
lifecycle_final |
boolean | 整个租赁已经结束,不会再发生状态变化。 |
delivery_final |
boolean | 分配尝试已经结束。true 本身不代表成功,请检查 failure。 |
failure |
object 或 null | 失败结果的稳定 code 和可安全显示的 message。 |
created_at、updated_at |
integer | Unix 秒。 |
何时停止轮询?
只有两个结束标志都为 true 才停止。完整租赁成功结束时状态为 rental_finished。failed 和 rental_interrupted 会包含 failure。
未找到
不存在的 ID 和其他账户的 ID 故意返回相同响应:
{"type":"https://rentron.xyz/docs/errors/codes#energy_order_not_found","title":"Not Found","status":404,"detail":"Order was not found.","code":"energy_order_not_found"}
Rentron