积分用户明细

请求路径

• 请求方式：POST
• 请求头：Content-Type:application/json
• 接口地址：https://gateway.nuoyunapi.com/Api/Points/GetWechatUserPointsDetail/2.0.0
• 频率限制：10秒100次

请求参数

参数	必选	类型	描述
wechat_user_space_id	否	integer/array	用户ID，非必填；支持单个数字或数组，最多300个；不传则不过滤用户
st	否	string	记录添加开始时间，按积分明细 add_time 筛选；格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS（仅传日期时按当天 00:00:00）
et	否	string	记录添加结束时间，按积分明细 add_time 筛选；格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS（仅传日期时按当天 23:59:59）
page	否	integer	页码，从1开始（默认值1）
page_size	否	integer	每页条数，最大300（默认值10）
order_direction	否	string	排序方式：asc（升序）、desc（降序），默认 desc，按积分明细记录ID排序

请求示例

{
  "wechat_user_space_id": [2040640, 45301495],
  "st": "2025-06-01",
  "et": "2025-06-30",
  "page": 1,
  "page_size": 10,
  "order_direction": "desc"
}

wechat_user_space_id 也可传单个数字，例如 "wechat_user_space_id": 2040640。

响应参数

参数	必选	类型	描述
code	是	integer	状态码：200-成功，400-失败
data	是	object	消息内容
msg	是	string	提示信息

data 参数结构

参数	必选	类型	描述
list	是	array	明细列表
total	是	integer	总数量

list 参数结构

参数	必选	类型	描述
id	是	integer	积分明细记录ID（排序字段）
wechat_user_space_id	是	integer	用户ID
room_id	是	integer	领取积分的直播间id
room_name	是	string	领取积分的直播间名称
add_time	是	string	积分变动时间
change_points_value	是	integer	变动积分值
task_type_desc	是	string	获得积分任务类型描述
type	是	integer	积分变动类型：1：做任务增加积分 2：积分免费兑换商品 3：售后扣减积分 4：售后增加积分 5: 退款退积分 6: 积分过期 7：积分抵现扣积分 8: 积分抵现退积分 13: 观看奖励增加积分
task_type	是	integer	获得积分任务类型：1：邀请分享观看 2：订阅直播 3：购买商品 4：直播间评论 5：直播间打赏 6：直播间送礼物 7：观看时长 8：每日签到 9：观看奖励
current_points	是	integer	当前积分
order_sn	是	string	获得积分的订单号
expire_date	是	string	积分过期时间
remarks	是	string	备注

响应示例

{
  "code": 200,
  "data": {
    "total": 18,
    "list": [
      {
        "id": 57513354,
        "wechat_user_space_id": 2040640,
        "room_id": 174434200,
        "room_name": "说的是",
        "add_time": "2025-06-11 16:01:35",
        "change_points_value": 1,
        "task_type_desc": "邀请分享观看",
        "type": 1,
        "task_type": 1,
        "current_points": 18,
        "order_sn": "",
        "expire_date": "2025-07-11 16:01:35",
        "remarks": ""
      }
    ]
  },
  "msg": "Success"
}