消息
站内消息和订阅。
查询消息列表
查询站内消息及当前用户的已读状态。普通用户仅能查询面向自己的已显示消息;管理员可查询所有消息,也可通过 receive 切换为指定用户视角。
标记消息已读
为当前登录用户创建指定消息的已读记录。请求可为单个对象或对象数组;重复标记不会重复插入记录。当前实现只校验消息是否存在,不验证消息接收范围。
查询消息通知订阅
查询当前登录用户按消息类型配置的短信与邮件通知订阅状态。接口只返回当前用户的记录。
更新消息通知订阅
更新当前用户指定消息类型的短信和邮件通知开关。请求可为单个对象或对象数组;服务端只更新已存在的订阅行,不会自动新增订阅类型。每个对象必须提供 msg_type,phone 和 email 均可省略;两者均省略时该对象不会写入任何字段。
获取消息详情
按消息 ID 获取一条消息的完整记录。已登录用户可读取公共消息(receive 为 0)和发送给自己的消息;其他用户的定向消息仅管理员可读取。