a508a4cfbc
前台联系人模块（ui-ux-pro-max 规范）： - contact/index.vue: 好友列表（搜索/在线状态/骨架屏） - contact/request.vue: 好友申请列表（接受/拒绝/防重复提交） - contact/detail.vue: 好友详情（备注/分组/拉黑/删除） - contact/search.vue: 搜索添加好友 + 好友推荐 - contact/groups.vue: 好友分组管理（CRUD） - contact/blacklist.vue: 黑名单管理 管理端前端： - views/monitor/online.vue: 在线监控（统计卡片/用户表格/30s 自动刷新） - views/contact/list.vue: 好友关系管理（分页表格/强制删除） - api/monitor.js + api/contact.js: 管理端 API 封装 - 路由 + 侧边栏导航更新 API 文档（4 份）： - docs/api/frontend/contact.md: 17 个接口完整文档 - docs/api/frontend/websocket.md: 前端 WS 事件协议 - docs/api/admin/online.md: 在线监控 API - docs/api/admin/contact.md: 好友管理 API 进度文档更新至 Phase 2a 全部完成 Made-with: Cursor
57 lines
1.0 KiB
Markdown
57 lines
1.0 KiB
Markdown
# 管理端在线监控 API
|
|
|
|
> 通用规范（认证方式、响应格式、错误码）见 [README.md](../README.md)
|
|
> 所有接口需要 JWT + admin/super_admin 角色权限
|
|
|
|
---
|
|
|
|
## 接口列表
|
|
|
|
| 方法 | 路径 | 权限 | 说明 |
|
|
|------|------|------|------|
|
|
| GET | /api/v1/admin/online/users | admin | 获取在线用户列表 |
|
|
| GET | /api/v1/admin/online/count | admin | 获取在线用户数量 |
|
|
|
|
---
|
|
|
|
## 1. 获取在线用户列表
|
|
|
|
`GET /api/v1/admin/online/users`
|
|
|
|
**说明：** 返回当前所有在线用户的基本信息。数据来源于 Redis SET `echo:user:online`。
|
|
|
|
**成功响应：**
|
|
```json
|
|
{
|
|
"code": 0,
|
|
"message": "ok",
|
|
"data": [
|
|
{
|
|
"user_id": 1,
|
|
"username": "super_admin"
|
|
},
|
|
{
|
|
"user_id": 2,
|
|
"username": "lisi"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 2. 获取在线用户数量
|
|
|
|
`GET /api/v1/admin/online/count`
|
|
|
|
**成功响应：**
|
|
```json
|
|
{
|
|
"code": 0,
|
|
"message": "ok",
|
|
"data": {
|
|
"count": 25
|
|
}
|
|
}
|
|
```
|