开发者文档

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

订单列表

// GET

生产 API

列出订单

使用不透明游标分页,按从新到旧的顺序读取订单。

GET /v1/energy/orders?limit=20&cursor=...
本页内容

该接口只返回与 API 凭证关联账户的订单。

查询参数

参数 类型 默认值 说明
limit integer 20 页大小,范围为 1 到 100。
cursor string 来自上一页 next_cursor 的不透明值。

签名包含开头的 ? 在内的完整查询字符串。签名后不要重新排序或重新编码。

响应 200

{"items":[{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"total_trx":"3.200000","status":"created","lifecycle_final":false,"delivery_final":false,"created_at":1784376000,"updated_at":1784376000,"failure":null}],"next_cursor":"opaque-value"}

items 按最新优先排序。next_cursor: null 表示没有更多页面。

游标规则

  • 原样传回游标。
  • 不要自行解码或构造游标。
  • 游标绑定到其所属账户和资源。
  • 无效、被修改或属于其他账户的游标会以 pagination_cursor_invalid 返回 400