v1.0.0 (2026-09-03 16:35)
获取红包列表
此接口用于获取玩家名下的红包列表,包含待领取、已领取和已过期的所有红包记录。
接口说明
路径: /client/angpao/list方法: GET鉴权: 必填 (Bearer Token)
请求参数
| 参数名 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
currency | string | 否 | - | 按币种过滤 (如: VND) |
page | int | 否 | 1 | 页码 |
pageSize | int | 否 | 10 | 每页数量 |
status | string | 否 | - | 状态过滤 (如: UNCLAIMED, CLAIMED, EXPIRED). 留空则返回全部记录 |
响应示例
json
{
"status": true,
"code": 0,
"data": {
"list": [
{
"id": "64bcdef123...",
"member_guid": "7a9e34...",
"currency": "VND",
"amount": 1442.00,
"title": "系统红包",
"status": "UNCLAIMED",
"valid_until": "2026-12-31T23:59:59Z",
"created_at": "2026-08-23T14:38:35Z"
}
],
"total": 100,
"page": 1,
"pageSize": 10
},
"msg": "success"
}