Skip to main content
GET
List purchase history
orders 端点返回您的购买历史,按时间倒序排列,使用键集分页。可按时间窗口和状态过滤,然后通过将 meta.next_cursor 作为 cursor 传回,遍历更早的页面。每个订单都附带逐件商品明细及其交付状态。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。

查询参数

integer
默认值:"50"
每页结果数。最小 1,最大 100
integer
仅返回在该 Unix 时间戳(秒)当时或之后创建的订单。
integer
仅返回在该 Unix 时间戳(秒)当时或之前创建的订单。
string
按订单状态过滤。可选值:completedholddeliveringpendingcancelledfailed 之一。
string
来自上次响应中 meta.next_cursor 的键集游标。传入以获取下一页。

响应字段

Order[]
必填
本页订单数组。
object
必填

示例请求

示例响应

错误代码

授权

Authorization
string
header
必填

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

查询参数

limit
integer
默认值:50

Results per page. 1–100. Default 50.

必填范围: 1 <= x <= 100
start_unix_time
integer

Only orders created at or after this Unix timestamp (seconds).

end_unix_time
integer

Only orders created at or before this Unix timestamp (seconds).

status
enum<string>

Filter by order status.

可用选项:
completed,
hold,
delivering,
pending,
cancelled,
failed
cursor
string

Keyset cursor from a previous response's meta.next_cursor.

响应

A page of orders.

data
object[]
必填
meta
object
必填