消息列表接口

概述

用于查询官方公告或系统消息列表。

• 调用方：小程序前端
• 请求方式：GET
• 请求路径：/messages
• 请求头要求：查询系统消息时需携带 Authorization

请求参数

参数	类型	必填	说明
type	string	是	official 或 system
pageNo	int	否	页码
pageSize	int	否	每页条数

返回参数

参数	类型	说明
list	array	消息列表
unreadCount	int	未读数
hasMore	bool	是否还有更多

成功示例

{"code":"0","message":"ok","data":{"list":[{"messageId":"m_1","title":"公告标题"}],"unreadCount":3,"hasMore":true}}

失败示例

错误码

• A0001
• A0003

接口约束

• 幂等要求：否
• 一致性要求：最终一致

前后端同步规则

• 进入列表页后刷新未读数

缓存与刷新策略

• 官方公告：可缓存 5 分钟
• 系统消息：不缓存