消息中心接口


获取消息列表

URL: GET /notification/list?page=1

Query:

字段 必填 说明
page 否 页码,从1开始
size 否 每页大小
search 否 搜索关键词
notification_type 否 消息类型,1系统消息,2推广消息
status 否 消息状态, SENT已发送, REVOKED已撤回
position 否 消息位置, POPUP弹窗, CENTER消息中心
send_start 否 发送开始日期, 2025-05-02
send_end 否 发送结束日期, 2025-05-12

输出: list<Notification>

Notification

字段 类型 说明
id string 消息id
title string 标题
content string 内容
notification_type number 消息类型,1系统消息,2推广消息
position string 消息位置, POPUP弹窗, CENTER消息中心
status bool 消息状态, SENT已发送, REVOKED已撤回
send_to_all bool 是否发送给所有人
send_to list<string> 发送对象用户id列表
sended_at string 发送时间

新增消息

URL: POST /notification/create

输入:

字段 类型 必填 说明
title string 是 标题
content string 是 内容
notification_type number 是 消息类型,1系统消息,2推广消息
position string 是 消息位置, POPUP弹窗, CENTER消息中心
send_to_all bool 否 是否发送给所有人, 确保send_to_all为true或send_to不为空
send_to list<string> 否 发送对象用户id列表, 确保send_to_all为true或send_to不为空

输出:

字段 类型 说明
id string id

更新消息

URL: POST /notification/{notification_id}/update

输入:

字段 类型 必填 说明
title string 是 标题
content string 是 内容
notification_type number 是 消息类型,1系统消息,2推广消息
position string 是 消息位置, POPUP弹窗, CENTER消息中心
send_to_all bool 否 是否发送给所有人, 确保send_to_all为true或send_to不为空
send_to list<string> 否 发送对象用户id列表, 确保send_to_all为true或send_to不为空

输出: 无


修改消息状态

URL: POST /notification/{notification_id}/change_status

输入:

字段 类型 必填 说明
status bool 是 消息状态, SENT已发送, REVOKED已撤回

输出: 无


删除消息

URL: POST /notification/deletes

输入:

字段 类型 必填 说明
ids list<string> 是 消息id列表

输出: 无