docs(user-v3): 站内信详情接口 GET /admin/message/{id} 已交付(PR #3490 验测过) — 更新前端待办清单

这个提交包含在:
API Changelog Bot 2026-06-05 11:10:24 +08:00
父节点 24e3181976
当前提交 1a9cab348a

查看文件

@ -27,6 +27,7 @@
2. **顶部全局铃铛**:未读红点 = `GET /admin/message/unread-count`,由 SSE 实时刷新。 2. **顶部全局铃铛**:未读红点 = `GET /admin/message/unread-count`,由 SSE 实时刷新。
3. **收件箱页组件**(平铺列表,内部员工统一 SYSTEM 分类,**不需要分类 tab** 3. **收件箱页组件**(平铺列表,内部员工统一 SYSTEM 分类,**不需要分类 tab**
- 列表 `GET /admin/message/list?pageNo=&pageSize=` - 列表 `GET /admin/message/list?pageNo=&pageSize=`
- 详情 `GET /admin/message/{id}`(🆕 深链/刷新/铃铛点击时按 ID 拉单条,返回完整 `content`/`link`;纯查询不改已读,不存在/越权返 code=200401「站内信不存在或无权访问」
- 单条/全部已读 `PUT /admin/message/{id}/read``PUT /admin/message/read-all` - 单条/全部已读 `PUT /admin/message/{id}/read``PUT /admin/message/read-all`
- 删除 `DELETE /admin/message/{id}` - 删除 `DELETE /admin/message/{id}`
4. **SSE 客户端**`new EventSource('https://api.test.1814.love:9443/ws/admin-msg/stream?token={admin token}')`,收到 `message` 事件刷新角标(详见 04_3414 §3 4. **SSE 客户端**`new EventSource('https://api.test.1814.love:9443/ws/admin-msg/stream?token={admin token}')`,收到 `message` 事件刷新角标(详见 04_3414 §3
@ -47,6 +48,7 @@
## 3. 后端状态(无需改动,已全部就绪) ## 3. 后端状态(无需改动,已全部就绪)
- 收件箱:`/admin/message/*`(列表/未读数/已读/删除)✅ 实测 200 - 收件箱:`/admin/message/*`(列表/未读数/已读/删除)✅ 实测 200
- **🆕 单条详情:`GET /admin/message/{id}`**PR #3490,2026-06-05 合 dev-v3 + 部署测试服)✅ 实测:命中返完整 VO含 content/link;不存在/越权返 code=200401 —— 给「我的消息」详情页深链/刷新用
- SSE 实时:`/ws/admin-msg/stream`(过网关 + nginx 实测收到事件)✅ - SSE 实时:`/ws/admin-msg/stream`(过网关 + nginx 实测收到事件)✅
- 选员工:`/admin/notification/custom-push/admins` ✅ 实测返 20 员工 - 选员工:`/admin/notification/custom-push/admins` ✅ 实测返 20 员工
- 发站内信:`POST /admin/notification/custom-push`ADMIN_INAPP✅ 实测落库 + SSE 推送 - 发站内信:`POST /admin/notification/custom-push`ADMIN_INAPP✅ 实测落库 + SSE 推送