v1.0.0 (2026-09-03 16:35)
活动体验金
此接口用于获取玩家的活动体验金(子钱包)列表。包含当前生效中、已完成以及已过期的所有记录。
获取体验金历史记录 (分页)
路径: /client/wallet/activity/list
方法: GET
鉴权: 必填 (Bearer Token)
请求参数
| 参数名 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
currency | string | 否 | - | 按币种过滤 (如: VND) |
page | int | 否 | 1 | 页码 |
pageSize | int | 否 | 10 | 每页数量 |
status | string | 否 | - | 状态过滤 (如: ACTIVE, SETTLED, FAILED). 留空则返回全部 |
响应示例
json
{
"status": true,
"code": 0,
"data": {
"list": [
{
"id": "64bcdef123...",
"currency": "VND",
"balance": 100.0,
"current_turnover": 500.0,
"target_turnover": 500.0,
"status": "SETTLED"
}
],
"total": 1,
"page": 1,
"pageSize": 10
},
"msg": "获取成功"
}