我的中奖记录接口

接口概述

• 接口名称：我的中奖记录
• 接口用途：查询用户中奖记录与领取状态
• 调用方：小程序前端
• 请求方式：GET
• 请求路径：/prizes/winnings
• 请求头要求：Authorization

请求参数

参数	类型	必填	说明
pageNo	int	否	页码
pageSize	int	否	每页条数

返回参数

参数	类型	说明
list	array	中奖记录列表
hasMore	bool	是否还有更多

list 元素示例字段

字段	类型	说明
recordId	string	中奖记录 ID
prizeName	string	奖品名称
claimStatus	string	领取状态

成功示例

{"code":"0","message":"ok","data":{"list":[{"recordId":"lr_1","prizeName":"西湖徽章","claimStatus":"issued"}],"hasMore":false}}

失败示例

错误码

错误码	说明
A0001	请先登录后查看中奖信息

接口约束与规则

• 幂等要求：否
• 前后端同步规则：客服更新领取状态后，前端重新进入列表需回源刷新
• 缓存/刷新策略：不缓存
• 一致性要求：强一致

实现要点

• 接口需进行登录态校验，依赖 Authorization 请求头。
• 分页参数 pageNo、pageSize 为可选，前端可按需传入。
• 由于领取状态可能被客服侧更新，列表页重新进入时必须拉取最新数据，不应使用本地缓存结果。