徽章列表接口

概述

用于获取用户徽章列表及徽章统计信息。

基本信息

项目	内容
接口名称	徽章列表
接口用途	获取用户徽章列表与统计
调用方	小程序前端
请求方式	GET
请求路径	/badges
请求头要求	Authorization

请求参数

参数	类型	必填	说明
status	string	否	徽章状态过滤，取值：unlocked / locked / all

返回参数

参数	类型	说明
unlockedCount	int	已解锁数量
totalCount	int	总数
list	array	徽章列表

成功示例

{"code":"0","message":"ok","data":{"unlockedCount":2,"totalCount":6,"list":[{"badgeId":"b_1","unlockStatus":"unlocked"}]}}

失败示例

错误码

错误码	说明
A0001	请先登录后查看徽章

接口约束与同步规则

项目	说明
幂等要求	否
前后端同步规则	解锁徽章后立即回刷
缓存/刷新策略	缓存 30 秒
一致性要求	强一致

说明

• 该接口依赖登录态，请求时需携带 Authorization 请求头。
• 前端在徽章解锁后应立即刷新列表，保证展示与服务端数据一致。
• 接口采用短时缓存策略，缓存时长为 30 秒。