09. 完整路由索引
说明：Auth 列含义
- Public：无需登录
- JWT：需要 Authorization: Bearer ...
- JWT+Approved：需要登录且账号审核通过
- Admin：管理员
- Admin/Owner：管理员或群主
1. 认证/公开
| Method |
Path |
Auth |
说明 |
| POST |
/api/auth/login |
Public |
账号密码登录 |
| POST |
/api/auth/logout |
Public |
登出并清 Cookie |
| POST |
/api/auth/refresh |
Public |
刷新 access token |
| POST |
/api/auth/register |
Public |
注册 |
| POST |
/api/auth/ws-token/clear |
Public |
清理 ws_token |
| POST |
/api/auth/email-login |
Public |
邮箱验证码登录 |
| POST |
/api/auth/send-code |
Public |
发送邮箱验证码 |
| POST |
/api/auth/verify-email |
Public |
注册邮箱验证码校验 |
| POST |
/api/auth/reset-password |
Public |
邮箱重置密码 |
| GET |
/api/captcha |
Public |
获取图片验证码 |
| GET |
/api/platform/info |
Public |
平台信息 |
| GET |
/api/platform/totalstats |
Public |
平台统计 |
| GET |
/api/config/public |
Public |
公开站点配置 |
| GET |
/api/public/relays |
Public |
公开中继查询 |
2. SSO
| Method |
Path |
Auth |
说明 |
| GET |
/api/sso/login |
Public |
获取 SSO 登录 URL |
| GET |
/api/sso/callback |
Public |
SSO 回调 |
| POST |
/api/sso/exchange |
Public |
一次性交换码换 token |
| GET |
/api/sso/status |
JWT |
当前用户 SSO 绑定状态 |
| POST |
/api/sso/bind |
JWT |
发起 SSO 绑定 |
| DELETE |
/api/sso/unbind |
JWT |
解绑 SSO |
3. 用户资料
| Method |
Path |
Auth |
说明 |
| POST |
/api/auth/ws-token/sync |
JWT |
同步 ws_token Cookie |
| GET |
/api/me |
JWT |
当前用户信息 |
| PUT |
/api/me |
JWT |
更新个人资料 |
| PUT |
/api/me/password |
JWT |
修改自己密码 |
| PUT |
/api/me/email |
JWT |
修改邮箱 |
| PUT |
/api/users/:id/password |
JWT |
管理员或本人改密码 |
| GET |
/api/users/:id/public |
JWT |
按 ID 获取用户公开信息 |
| GET |
/api/users/name/:username/public |
JWT |
按用户名获取用户公开信息 |
4. 设备动态码绑定
| Method |
Path |
Auth |
说明 |
| POST |
/api/device/pre-check |
Public |
设备预检查 |
| POST |
/api/device/request-code |
Public |
请求动态码 |
| POST |
/api/device/confirm-bind |
Public |
轮询绑定状态 |
| POST |
/api/device/bind |
JWT |
Web 端绑定设备 |
| POST |
/api/device/submit-config |
JWT |
提交绑定配置 |
| GET |
/api/user/device-password |
JWT |
获取设备准入密码 |
| PUT |
/api/user/device-password |
JWT |
修改设备准入密码 |
| POST |
/api/user/device-password/regenerate |
JWT |
重新生成设备准入密码 |
5. 设备管理
| Method |
Path |
Auth |
说明 |
| GET |
/api/devices |
JWT+Approved |
设备列表 |
| GET |
/api/devices/list |
JWT+Approved |
兼容旧路径（同上） |
| GET |
/api/device/get |
JWT+Approved |
设备详情（query id） |
| GET |
/api/device/qth |
JWT+Approved |
兼容路径（同 device/get） |
| GET |
/api/device/qths |
JWT+Approved |
设备位置列表 |
| PUT |
/api/devices/:id |
JWT+Approved |
更新设备（含设备级禁发/禁收） |
| DELETE |
/api/devices/:id |
JWT+Approved |
删除设备 |
| POST |
/api/device/changegroup |
JWT+Approved |
切换设备群组 |
| PUT |
/api/devices/:id/group |
JWT+Approved |
切换设备群组（REST 风格） |
| POST |
/api/device/at |
JWT+Approved |
设备 AT |
| POST |
/api/device/query |
JWT+Approved |
查询设备参数 |
| POST |
/api/device/change |
JWT+Approved |
修改设备参数 |
| POST |
/api/device/change1w |
JWT+Approved |
修改 1W 参数 |
| POST |
/api/device/change2w |
JWT+Approved |
修改 2W 参数 |
| GET |
/api/devices/:id/config |
JWT+Approved |
读取设备配置 |
| PUT |
/api/devices/:id/config |
JWT+Approved |
保存设备配置 |
| POST |
/api/devices/:id/config/sync |
JWT+Approved |
下发设备配置 |
6. 群组
| Method |
Path |
Auth |
说明 |
| GET |
/api/groups |
JWT+Approved |
群组列表 |
| GET |
/api/group/list |
JWT+Approved |
兼容路径 |
| GET |
/api/groups/:id |
JWT+Approved |
群组详情 |
| GET |
/api/groups/:id/devices |
JWT+Approved |
群组设备列表 |
| POST |
/api/groups |
JWT+Approved |
创建群组 |
| POST |
/api/group/create |
JWT+Approved |
兼容路径 |
| POST |
/api/groups/search |
JWT+Approved |
搜索群组 |
| POST |
/api/groups/:id/join |
JWT+Approved |
加入私有群组 |
| GET |
/api/groups/:id/members |
JWT+Approved |
群组成员 |
| POST |
/api/groups/:id/leave |
JWT+Approved |
退出群组 |
| PUT |
/api/groups/:id |
Admin/Owner |
更新群组 |
| DELETE |
/api/groups/:id |
Admin/Owner |
删除群组 |
| POST |
/api/group/update |
Admin/Owner |
兼容路径（不建议） |
| POST |
/api/group/delete |
Admin/Owner |
兼容路径（不建议） |
| DELETE |
/api/groups/:id/devices/:deviceId |
Admin/Owner |
踢出设备 |
7. 虚拟互联组
| Method |
Path |
Auth |
说明 |
| POST |
/api/group-links |
Admin |
创建虚拟互联组 |
| GET |
/api/group-links |
Admin |
互联组列表 |
| GET |
/api/group-links/available-targets |
Admin |
可关联目标群组 |
| GET |
/api/group-links/:id |
Admin |
互联组详情 |
| PUT |
/api/group-links/:id |
Admin |
更新互联组 |
| DELETE |
/api/group-links/:id |
Admin |
删除互联组 |
| GET |
/api/group-links/:id/targets |
Admin |
查询关联目标 |
| POST |
/api/group-links/:id/targets |
Admin |
增加关联目标 |
| DELETE |
/api/group-links/:id/targets/:targetId |
Admin |
移除关联目标 |
8. 在线收发（Radio）
| Method |
Path |
Auth |
说明 |
| GET |
/api/radio/config |
JWT+Approved |
在线收发配置 |
| PUT |
/api/radio/ssid |
JWT+Approved |
更新 SSID |
| GET |
/api/radio/status |
JWT+Approved |
幽灵设备状态 |
| GET |
/api/radio/groups/stats |
JWT+Approved |
群组实时统计 |
| GET |
/api/radio/groups/:id/devices |
JWT+Approved |
群组在线设备 |
| PUT |
/api/radio/group |
JWT+Approved |
切换幽灵设备群组 |
| GET |
/api/radio/conflict |
JWT+Approved |
幽灵连接冲突检查 |
9. 上传与审批
| Method |
Path |
Auth |
说明 |
| POST |
/api/upload/file |
JWT |
通用文件上传 |
| POST |
/api/upload/operator-certificate |
JWT |
上传操作证 |
| GET |
/api/operator-certificate |
JWT |
查询本人操作证 |
| GET |
/api/approvals/pending |
Admin |
用户审批列表 |
| PUT |
/api/approvals/:id/approve |
Admin |
用户审批 |
| GET |
/api/certificate-approvals |
Admin |
操作证审批列表 |
| PUT |
/api/operator-certificates/:id/approve |
Admin |
操作证审批 |
| POST |
/api/upload/logo |
Admin |
上传站点 Logo |
| DELETE |
/api/config/logo |
Admin |
删除 Logo 配置 |
| POST |
/api/upload/favicon |
Admin |
上传 Favicon |
| DELETE |
/api/config/favicon |
Admin |
删除 Favicon 配置 |
10. 通联日志与通信记录
| Method |
Path |
Auth |
说明 |
| GET |
/api/logbooks |
JWT |
我的通联日志列表 |
| GET |
/api/logbooks/:id |
JWT |
我的通联日志详情 |
| POST |
/api/logbooks |
JWT |
创建通联日志 |
| PUT |
/api/logbooks/:id |
JWT |
更新通联日志 |
| DELETE |
/api/logbooks/:id |
JWT |
删除通联日志 |
| DELETE |
/api/logbooks/batch |
JWT |
批量删除通联日志 |
| GET |
/api/admin/logbooks |
Admin |
管理员日志列表 |
| GET |
/api/admin/logbooks/:id |
Admin |
管理员日志详情 |
| PUT |
/api/admin/logbooks/:id |
Admin |
管理员更新日志 |
| DELETE |
/api/admin/logbooks/:id |
Admin |
管理员删除日志 |
| DELETE |
/api/admin/logbooks/batch |
Admin |
管理员批量删除 |
| GET |
/api/comm-records |
JWT |
通信记录列表 |
| GET |
/api/comm-records/user-stats |
JWT |
当前用户通信统计 |
| GET |
/api/comm-records/user-trend |
JWT |
当前用户通信趋势 |
| GET |
/api/comm-records/:id |
JWT |
通信记录详情 |
| DELETE |
/api/comm-records/:id |
Admin |
删除通信记录 |
| GET |
/api/comm-records/stats |
Admin |
录制器统计 |
| GET |
/api/comm-records/system-stats |
Admin |
系统通信统计 |
| GET |
/api/comm-records/system-trend |
Admin |
系统通信趋势 |
11. 预设
| Method |
Path |
Auth |
说明 |
| GET |
/api/user/radio-presets |
JWT |
获取预设 |
| POST |
/api/user/radio-presets |
JWT |
创建预设 |
| PUT |
/api/user/radio-presets/:id |
JWT |
更新预设 |
| DELETE |
/api/user/radio-presets/:id |
JWT |
删除预设 |
| PUT |
/api/user/radio-presets/reorder |
JWT |
重排预设 |
12. 中继台/服务器/日志/缓存/配置
| Method |
Path |
Auth |
说明 |
| GET |
/api/relays |
Admin |
中继台列表 |
| GET |
/api/relay/list |
Admin |
兼容路径 |
| POST |
/api/relay/create |
Admin |
创建中继台 |
| POST |
/api/relay/update |
Admin |
更新中继台 |
| POST |
/api/relay/delete |
Admin |
删除中继台 |
| GET |
/api/servers |
Admin |
服务器列表 |
| GET |
/api/server/list |
Admin |
兼容路径 |
| POST |
/api/server/create |
Admin |
创建服务器 |
| POST |
/api/server/update |
Admin |
更新服务器 |
| POST |
/api/server/delete |
Admin |
删除服务器 |
| GET |
/api/admin/devices/:id/config |
Admin |
任意设备配置读取 |
| PUT |
/api/admin/devices/:id/config |
Admin |
任意设备配置更新 |
| POST |
/api/admin/devices/:id/config/sync |
Admin |
任意设备配置下发 |
| GET |
/api/operatorlog/list |
Admin |
操作日志列表 |
| GET |
/api/operatorlog/stats |
Admin |
操作日志统计 |
| GET |
/api/config/comm-settings |
Admin |
通信设置读取 |
| PUT |
/api/config/comm-settings |
Admin |
通信设置更新 |
| GET |
/api/cache/metrics |
Admin |
缓存指标 |
| POST |
/api/cache/metrics/reset |
Admin |
重置缓存指标 |
| POST |
/api/cache/clear |
Admin |
清空缓存 |
| GET |
/api/config/category/:category |
JWT |
分类配置读取 |
| PUT |
/api/config |
Admin |
通用配置更新 |
| PUT |
/api/config/icp |
Admin |
ICP 配置更新 |
| PUT |
/api/config/system |
Admin |
系统配置更新 |
| PUT |
/api/config/aprs |
Admin |
APRS 配置更新 |
| PUT |
/api/config/openai |
Admin |
OpenAI 配置更新 |
| GET |
/api/config/all |
Admin |
全部配置 |
| GET |
/api/config/system |
Admin |
系统配置读取 |
| GET |
/api/config/aprs |
Admin |
APRS 配置读取 |
| GET |
/api/config/openai |
Admin |
OpenAI 配置读取 |
| GET |
/api/config/aprs/logs |
Admin |
APRS 最近日志 |
| GET |
/api/config/smtp |
Admin |
SMTP 配置读取 |
| PUT |
/api/config/smtp |
Admin |
SMTP 配置更新 |
13. 资源中心
| Method |
Path |
Auth |
说明 |
| GET |
/api/assets |
Admin |
资源列表（parent_id） |
| POST |
/api/assets/folder |
Admin |
创建文件夹 |
| POST |
/api/assets/upload |
Admin |
上传文件 |
| PUT |
/api/assets/:id |
Admin |
更新资源 |
| PUT |
/api/assets/:id/move |
Admin |
移动资源 |
| POST |
/api/assets/:id/replace |
Admin |
覆盖文件 |
| DELETE |
/api/assets/:id |
Admin |
删除资源 |
| GET |
/api/assets/tree |
Public |
目录树 |
| GET |
/api/assets/folder/:id |
Public |
文件夹内容 |
| GET |
/api/assets/:id/download |
Public |
下载链接 |
14. WebSocket
| Method |
Path |
Auth |
说明 |
| GET |
/ws |
Cookie(ws_token) |
WebSocket 实时通联 |