# 获取积分变动流水列表

请求方式:POST

请求地址:https://api.aquanliang.com/gateway/eaopen/GetPointsAccountTraceList

body参数

{
  "plan_id": "plan1232",
  "start_ts": 1637115530,
  "end_ts" : 1637115531,
  "offset" : 0,
  "limit": 10
}
字段 类型 必填 说明
plan_id string 活动ID
start_ts timestamp 要查询的流水时间范围开始时间戳
end_ts timestamp 要查询的流水时间范围结束时间戳
offset int 每次获取的的开始位置,最小值为0
limit int 每次获取的条数,取值范围(1~100)

返回值:

{
  "data": {
    "has_more": false,
    "list": [
      {
        "action": 3,
        "external_user_id": "wofd4MDA483028506D1I4g",
        "group_id_list": ["12345"],
        "id": "618c5749362397c28fbd709",
        "open_id": "accdgjrih439gf0e1ufshYyn",
        "operation": 1,
        "points": 100,
        "union_id": "8543jfiorej0"
      }
    ]
  },
  "errcode": 0,
  "errmsg": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
has_more bool 是否还有更多
list array 积分流水变动列表

list数据结构

字段 类型 说明
action int 积分变动项
1: 签到
2: 发言
3: 留存
4: 用户离开活动相关群产生积分清理
5: 自定义积分
6: 积分消费
external_user_id string 企微外部联系人ID
group_id_list array 变动项关联的群ID
id string 流水ID
open_id string 成员ID
operation int 积分操作项
1: 增加
2: 减少
points int 变动积分
union_id string 企微union_id

完整请求示例:

curl -X POST \
  https://api.aquanliang.com/gateway/eaopen/GetPointsAccountTraceList \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
    "plan_id": "plan1232",
    "start_ts": 1637115530,
    "end_ts" : 1637115531,
    "offset" : 0,
    "limit": 10
}'