获取红包领取记录
| 拥有此API的权限集 |
|---|
| 直播管理-查询 |
请求方式及url
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
https://api.xiaoe-tech.com/xe.live.redpacket.record/1.0.0 - 频率限制:
10秒3000次
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 专属token |
| resource_id | 是 | string | 资源id |
| resource_type | 是 | int | 资源类型 |
| red_packet_id | 是 | int | 红包ID |
| current_user_id | 否 | string | 当前用户 |
| page | 否 | int | 页码 |
| limit | 否 | int | 条数 |
请求示例
{
"access_token":"xe_xxx",
"id":"5zO2dQ1lo6dn",
"resource_id":"l_61a6eaebe4b0cc47c3c0f51f",
"resource_type":4
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 返回码 |
| msg | string | 返回信息 |
| data | array | 返回值 |
| data.send_info | object | 红包发起人信息 |
| data.record_list | object | 领取列表 |
data.send_info红包发起人信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 红包id |
| app_id | string | 店铺id |
| order_id | string | 关联订单id |
| user_id | string | 红包发起人id |
| resource_id | string | 资源id |
| resource_type | number | 资源类型 |
| r_type | number | 红包类型;1-普通红包 |
| state | number | 红包状态;0-预创建,1-进行中,2-已结束,3-已过期,4-异常红包 |
| receive_type | number | 领取类型;1-拼手气红包,2-等额红包 |
| money | number | 原始金额(分) |
| average_price | string | receive_type=2时 记录单个金额 |
| receive_number | int | 领取数量 |
| after_deduction_money | number | 扣除手续费后金额(分) |
| num | number | 红包个数 |
| describe_msg | string | 红包描述 |
| created_at | string | 创建时间 |
| refund_money | number | 退款金额 |
| refund_time | string | 退款时间 |
| wx_nickname | string | 用户昵称(发起人) |
| wx_avatar | string | 用户头像(发起人) |
data.record_list领取列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| user_id | string | 领取用户id |
| wx_nickname | string | 用户昵称(领取人) |
| wx_avatar | string | 用户头像(领取人) |
| created_at | string | 领取时间 |
| money | number | 领取金额(分) |
| id | string | 红包id |
| order_id | string | 关联订单id |
| resource_id | string | 资源id |
| resource_type | number | 资源类型 |
| send_user_id | string | 红包发起人 |
| describe_msg | string | 红包描述 |
| is_optimum_luck | boolean | 是否最佳手气 |
| forward_url | string | 无 |
| is_svip | bool | 用户是否是SVIP用户 (true-是;false-否) |
| svip_id | string | 超级会员id 若is_svip为false,则为空字符串 |
返回示例
{
"code": 0,
"msg": "success",
"data": {
"send_info": {
"id": "WZ7VqzVbq69y",
"app_id": "apppcHqlTPT3482",
"order_id": "o_id",
"user_id": "u_6034cc9d2fbd2_4AWKbdNIRq",
"resource_id": "r_id",
"resource_type": 4,
"r_type": 1,
"state": 1,
"receive_type": 1,
"money": 100,
"after_deduction_money": 100,
"num": 5,
"describe_msg": "",
"created_at": "2021-04-28 15:53:12",
"refund_money": 0,
"refund_time": "0000-00-00 00:00:00",
"wx_nickname": "無",
"wx_avatar": "https://thirdwx.qlogo.cn/mmopen/vi_32/ZQd1J0PhibAQeKS17SGTGABJ0O9BnuZhIXuckDibAGC6sSRIr7PvgPvQ53SFyBBoc3Abo0Kd5DwuyicunUeyO8Bog/132"
},
"record_list": [
{
"user_id": "u_6034cc9d2fbd2_4AWKbdNIRq",
"wx_nickname": "Davis",
"wx_avatar": "http://xx.com/api/user/register",
"created_at": "2021-04-28 16:18:18",
"is_svip": false,
"svip_id": "",
"money": 29,
"id": "WZ7VqzVbq69y",
"order_id": "o_id",
"resource_id": "r_id",
"resource_type": 4,
"send_user_id": "u_6034cc9d2fbd2_4AWKbdNIRq",
"describe_msg": "",
"is_optimum_luck": true
},
{
"user_id": "u_5f4368465031a_JPBmETdeFV",
"wx_nickname": "Davis",
"wx_avatar": "http://xx.com/api/user/register",
"created_at": "2021-04-28 16:16:51",
"money": 5,
"id": "WZ7VqzVbq69y",
"order_id": "o_id",
"resource_id": "r_id",
"resource_type": 4,
"send_user_id": "u_6034cc9d2fbd2_4AWKbdNIRq",
"describe_msg": "",
"is_optimum_luck": false
}
]
},
"forward_url": ""
}