生产 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。
Rentron