抽奖配置接口

概述

用于获取抽奖奖盘配置以及当前用户积分信息。

基本信息

• 接口名称：抽奖配置
• 接口用途：获取奖盘配置和当前用户积分
• 调用方：小程序前端
• 请求方式：GET
• 请求路径：/lottery/config
• 请求头要求：Authorization

请求参数

无。

返回参数

参数	类型	说明
costPoints	int	单次抽奖消耗积分
currentPoints	int	当前积分
prizes	array	8 个奖品配置

返回示例

成功示例

{"code":"0","message":"ok","data":{"costPoints":20,"currentPoints":150,"prizes":[{"prizeId":"p1","prizeName":"10积分"}]}}

失败示例

错误码

错误码	说明
A0001	请先登录后参与抽奖

接口约束

• 幂等要求：否
• 前后端同步规则：当前积分以服务端返回为准
• 缓存/刷新策略：页面进入回源获取
• 一致性要求：强一致

实现说明

• 前端进入抽奖页面时应主动请求该接口，确保奖盘配置与积分数据为最新状态。
• 当前积分不可使用本地缓存值覆盖，应以服务端返回的 currentPoints 为准。
• 调用接口前需确保用户已登录，并正确携带 Authorization 请求头。