# 获取红包领取记录 |拥有此API的权限集| |:----- | | 直播管理-查询直播信息 | **请求方式及url** - 请求方式：`POST` - 请求头：`Content-Type:application/json` - 接口地址：`https://api.xiaoe-tech.com/xe.live.redpacket.record/1.0.0` - 频率限制: `10秒3000次` {% api method="POST", data= { "access_token":"xe_xxx", "id":"5zO2dQ1lo6dn", "resource_id":"l_61a6eaebe4b0cc47c3c0f51f", "resource_type":4 }, url="https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/xe.live.redpacket.record/1.0.0" %} {% endapi %} **请求参数** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |access_token |是 |string |[专属token](./../get_access_token.md) | |resource_id |是 |string |资源id | |resource_type |是 |int |资源类型 | |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": "" } ```