# P27 接口清单

前缀 `/api/message`，统一返回 `{ code, message, data }`。

## 1 站内信箱

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | /list | 消息列表（类型、已读状态、时间范围、分页） |
| GET | /unread-count | 未读数量（按类型分组） |
| POST | /read | 标记已读（支持批量 id） |
| POST | /read-all | 全部已读（按类型可选） |
| GET | /detail | 消息详情与跳转链接 |

## 2 模板管理

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | /template/list | 模板列表 |
| POST | /template/save | 新建或更新模板 |
| POST | /template/toggle | 启用或停用 |
| GET | /template/history | 模板版本历史 |
| POST | /template/rollback | 回滚到指定版本 |
| POST | /template/preview | 变量渲染预览 |

## 3 订阅与路由

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | /subscription | 获取当前账号订阅配置 |
| POST | /subscription/save | 保存订阅（业务域 + 渠道） |
| GET | /channel | 可用渠道与必达规则 |
| POST | /do-not-disturb | 设置免打扰时段 |

## 4 发送与记录

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | /send | 内部服务触发发送（需服务间鉴权） |
| POST | /broadcast | 运营群发（需二次确认令牌） |
| GET | /record/list | 发送记录（状态、失败原因、重试次数） |
| POST | /record/retry | 手动重试失败消息 |

## 5 约定

- 内部发送接口只允许服务端调用，需签名与来源白名单。
- 群发必须带 `confirm_token`，缺省拒绝。
- 发送失败三次进入人工处理队列，不在前台自动无限重试。
- 所有模板变更与群发动作写审计日志。