端点清单#

本机运维代理服务（agent-service，Rust）端点全量清单（5 端点）。服务直接运行在中心服务器主机上（默认端口 8066，无网关前缀），鉴权为可选 token 查询参数（源码归纳：该值的生成算法属于内部实现，不在文档披露范围，具体生成方式请与开发人员沟通确认）。请求规范见接口规范；交互调试见 Swagger 视图。

数据源：局域网 agent 实例（2026-09-14 现场拉取，http://192.168.1.53:8066/api-docs/openapi.json）。

本页由脚本生成，不可手改，重跑生成器整体覆盖。

方法	路径	说明	详情
POST	/agent-api/v1/db/backup	触发一次 PostgreSQL 数据库备份	Swagger
GET	/agent-api/v1/db/backup/download/{filename}	下载指定数据库备份文件	Swagger
GET	/agent-api/v1/db/backup/list	列出已有数据库备份文件	Swagger
GET	/agent-api/v1/system/timestamp	查询服务器系统时间戳	Swagger
GET	/agent-api/v1/user/{username}	按用户名查询操作系统用户信息	Swagger

endpoint-sections 端点分节（深链锚点）#

以下小节标题带 ASCII 前缀，供场景页深链引用（如 ./endpoints.md#db-backup-trigger-触发一次-postgresql-数据库备份，锚点 = 小节标题全文的 slug）。

db-backup-trigger 触发一次 PostgreSQL 数据库备份#

项	值
方法	POST
路径	/agent-api/v1/db/backup
分组	数据库备份（backup_handler）
鉴权	可选 token 查询参数（源码归纳）
详情	Swagger 视图

db-backup-download 下载指定数据库备份文件#

项	值
方法	GET
路径	/agent-api/v1/db/backup/download/{filename}
分组	数据库备份（backup_handler）
鉴权	可选 token 查询参数（源码归纳）
详情	Swagger 视图

db-backup-list 列出已有数据库备份文件#

项	值
方法	GET
路径	/agent-api/v1/db/backup/list
分组	数据库备份（backup_handler）
鉴权	可选 token 查询参数（源码归纳）
详情	Swagger 视图

system-timestamp 查询服务器系统时间戳#

项	值
方法	GET
路径	/agent-api/v1/system/timestamp
分组	系统（system_handler）
鉴权	可选 token 查询参数（源码归纳）
详情	Swagger 视图

user-get 按用户名查询操作系统用户信息#

项	值
方法	GET
路径	/agent-api/v1/user/{username}
分组	用户（user_handler）
鉴权	可选 token 查询参数（源码归纳）
详情	Swagger 视图