开发者文档

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

查询订单

// GET

生产 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 createdexecutingdeliveredrental_finishedfailedrental_interrupted
lifecycle_final boolean 整个租赁已经结束,不会再发生状态变化。
delivery_final boolean 分配尝试已经结束。true 本身不代表成功,请检查 failure
failure object 或 null 失败结果的稳定 code 和可安全显示的 message
created_atupdated_at integer Unix 秒。

何时停止轮询?

只有两个结束标志都为 true 才停止。完整租赁成功结束时状态为 rental_finishedfailedrental_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"}