列出购买

分页列出购买记录。支持按 member_id、product_id、status 过滤。

GET/v1/purchases

参数

参数	类型	位置	说明
`Authorization`必填	`string`	Header	Bearer {secret_key}
`member_id`可选	`string`	Query	按成员过滤。
`status`可选	`string`	Query	completed \| pending \| refunded
`limit`可选	`integer`	Query	每页数量，默认 20。

请求示例

HTTP

GET /v1/purchases?member_id=mem_001&status=completed HTTP/1.1
Host: api.subhub.dev
Authorization: Bearer sk_live_neostudio_8f3k2m9x4l0p7q2r5s8u1v

响应示例

HTTP

HTTP/1.1 200 OK
Content-Type: application/json

{
  "object": "list",
  "data": [
    {
      "id": "pur_001",
      "member_id": "mem_001",
      "product_id": "prod_01PROMO",
      "provider": "apple",
      "status": "completed",
      "amount": 18,
      "currency": "CNY",
      "created_at": "2026-06-27T18:32:00.000Z"
    }
  ],
  "has_more": false
}

代码示例

var components = URLComponents(string: "https://api.subhub.dev/v1/purchases")!
components.queryItems = [
    URLQueryItem(name: "member_id", value: "mem_001"),
    URLQueryItem(name: "status", value: "completed")
]