跳转到主要内容
GET
List Cards Transactions

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。 更多信息参见 关联账户

查询参数

page_size
integer
默认值:10
必填

每页返回的最大条目数。取值范围为 10 - 100,默认为 10。

必填范围: 10 <= x <= 100
page_number
integer
默认值:1
必填

用于获取下一组条目的页码。取值必须大于 1,默认为 1。

必填范围: x >= 1
card_id
string<uuid>

卡片的全局唯一标识符(UUID v4)。

示例:

"b3d9d2d5-4c12-4946-a09d-953e82sed2b0"

start_time
string

用于筛选的最早交易创建时间,ISO 8601 格式。start_timeend_time 之间的最大时间间隔为 90 天。

当取值包含时区偏移(如 +08:00)时,查询字符串中的 + 字符必须 URL 编码为 %2B——否则服务端会将其解析为空格并拒绝请求。示例:start_time=2024-03-21T17:17:32%2B08:00。以 Z 结尾的 UTC 取值(如 2024-03-21T09:17:32Z)无需编码。

示例:

"2024-03-21T09:17:32Z"

end_time
string

用于筛选的最晚交易创建时间,ISO 8601 格式。start_timeend_time 之间的最大时间间隔为 90 天。

当取值包含时区偏移(如 +08:00)时,查询字符串中的 + 字符必须 URL 编码为 %2B——否则服务端会将其解析为空格并拒绝请求。示例:end_time=2024-03-21T17:17:32%2B08:00。以 Z 结尾的 UTC 取值(如 2024-03-21T09:17:32Z)无需编码。

示例:

"2024-03-21T09:17:32Z"

响应

200 - application/json

成功返回卡片交易。

total_pages
integer

可用条目的总页数。

示例:

1

total_items
integer

可用条目的总数。

示例:

10

data
object[]