获取积分变动流水列表

说明 最多查询时间段跨度不能超过3个月，任意时间段最多查询3个月。

请求方式：POST

请求地址：https://$basehost/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": [
        {
            "id": "635fcd4d188380e9f7d4fdb3",
                "union_id": "owSkl6EAxLtnpeWynPne9qziOvJU",
                "external_user_id": "wmfd4MDAAA-Y9HqPbk-dDRqdMMRn0Q7Q",
                "group_id_list": [
                    "group3CQg3l2JtPK3r4xmGZoZ",
                    "groupKOd1N1f8Y3D06JNQo63l"
                ],
                "points": 499995,
                "operation": 2,
                "action": 4,
                "open_id": "accDfhtpjOES1DS5kfmtmYM",
                "points_action_time": 1654880406
        }
    ]
    },
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段	类型	说明
errcode	int	状态码，0为正常，非0代表错误
errmsg	string	错误信息
data	json	json返回值
has_more	bool	是否还有更多
list	array	积分流水变动列表
hint	string	请求日志ID

list数据结构

字段	类型	说明
action	int	积分变动项 1: 签到 2: 发言 3: 留存 4: 用户离开活动相关群产生积分清理 5: 手动设置积分 6: 积分消费 7: 积分导入 8: 自定义积分 12: 答题积分 13: 积分过期清理
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
points_action_time	int	积分变动时间
remark	string	备注

完整请求示例：

curl -X POST \
  https://$basehost/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
}'