管理员登录
用户
| ID | 账号 | 联系人 | 通话记录 | 创建时间 | 操作 |
|---|
暂无用户
用户 的联系人
取消分配不会删除联系人主记录；添加联系人请到「联系人」板块，分配请到列表「分配用户」或「批量分配」。
| 姓名 | 电话 | 创建时间 | 操作 |
|---|
暂无联系人
用户 的通话记录
| 类型 | 状态 | 姓名 | 号码 | 时间 | 时长 | 录音 | 操作 |
|---|
暂无通话记录
推送消息
联系人
| 姓名 | 电话 | 分配用户数 | 创建时间 | 操作 |
|---|
暂无联系人
添加联系人
编辑联系人
已分配给的用户
| ID | 账号 | 角色 |
|---|
暂无分配用户
通话记录
时长范围：—
| 用户 | 类型 | 状态 | 姓名 | 号码 | 时间 | 时长 | 录音 | 操作 |
|---|
暂无通话记录
管理员账号
当前登录：
| ID | 账号 | 创建时间 | 操作 |
|---|
暂无管理员
使用手册
用户
管理 App 登录账号。可批量添加用户、查看某用户的联系人与通话记录，或删除用户（会同步清理其数据）。
消息
向全部或指定用户推送通知消息，App 消息中心可查看。
联系人
维护全局联系人主数据；「添加联系人」仅保存信息，「分配用户」或「批量分配」将联系人分配给 App 用户。分配时可推送通知（见上方设置）。
通话记录
按用户、号码、时间等筛选全量通话记录，可在线播放录音或删除记录。
设置
管理员账号与改密码、分配通知开关与文案。右上角可退出登录。
API 文档
自动展示后端接口说明，便于联调与排查；点击条目可展开查看参数与响应示例。
API文档
根据后端已注册的 FastAPI 路由自动生成；新增接口时使用 APIRouter 和 response_model 即可自动显示。
公共配置
除下列公开接口外，所有 /api/** 请求都必须携带登录 token。
公共请求头
Header必填说明示例
Authorization是*登录后颁发的 Bearer Token
Bearer <token>
Content-TypeJSON 时POST/PUT 发送 JSON 时使用
application/json
* 公开接口、静态资源、录音下载的 ?token= 例外见下文。
获取 Token
POST /api/auth/login
Content-Type: application/json
{"username":"admin","password":"your-password"}
{
"code": 0,
"message": "ok",
"data": {
"token": "xxxxxxxx",
"user": { "id": 1, "username": "admin", "is_admin": true }
}
}
Token 有效期 7 天。Web 管理端保存在 localStorage；App 保存在本地存储。服务重启后内存 token 会失效，需重新登录（后续计划迁移 Redis）。
公开接口（无需 Authorization）
GET /api/healthGET /api/auth/statusPOST /api/auth/loginPOST /api/auth/init
统一响应包装
{ "code": 0, "message": "ok", "data": { } }
code === 0 为成功；失败时 code !== 0 或 HTTP 401/403，message 为错误说明。
特殊说明
- 录音下载
GET /api/call-logs/{id}/recording*支持 query：?token=<token>（便于 audio 标签播放） - App 上传通话记录：先将录音直传 OSS，再
POST /api/call-logs提交 JSON（含recording_path等oss:路径） - 管理后台前端请求会自动附加
Authorization: Bearer ...，401 时跳转登录页
点击“刷新文档”或重新进入本板块加载 API 文档