积分账户与明细接口

概述

用于获取用户当前积分余额及积分流水明细。

• 接口名称：积分账户与明细
• 接口用途：获取积分余额与流水
• 调用方：小程序前端
• 请求方式：GET
• 请求路径：/points/account
• 请求头要求：Authorization

请求参数

参数	类型	必填	说明
flowType	string	否	流水类型筛选，取值：all / increase / decrease
pageNo	int	否	页码
pageSize	int	否	每页条数

返回参数

参数	类型	说明
balance	int	当前积分余额
list	array	流水列表
hasMore	bool	是否还有更多

流水项示例字段

参数	类型	说明
flowId	string	流水 ID
pointsDelta	int	本次积分变动值

成功示例

{"code":"0","message":"ok","data":{"balance":220,"list":[{"flowId":"pf_1","pointsDelta":10}],"hasMore":true}}

失败示例

错误码

错误码	说明
A0001	登录状态已失效，请重新授权后继续

接口约束

项目	说明
幂等要求	否
前后端同步规则	关键动作完成后，积分页需回源刷新
缓存/刷新策略	不缓存
一致性要求	强一致

实现要点

• 请求必须携带 Authorization 请求头。
• 积分页在关键动作完成后应主动回源刷新，避免余额或流水展示滞后。
• 接口数据采用不缓存策略，以满足强一致要求。
• 分页场景下可结合 hasMore 判断是否继续加载下一页。