附录 C: 全部 API 端点参考目录
Daemon HTTP API (port 13456) + WebUI SPA (port 13457) 完整端点映射 2026-06-25
1. Daemon HTTP API (localhost:13456)
1.1 会话管理
| 方法 | 端点 | 请求体 | 说明 |
|---|---|---|---|
| GET | /sessions | — | 获取所有项目会话列表 |
| GET | /sessions/search?q=<keyword> | — | 按名称搜索会话 |
| GET | /projects | — | 获取项目列表 |
| GET | /project | — | 获取当前项目信息 |
| GET | /projects/:hash/sessions/:id | — | 获取指定会话详情 |
| DELETE | /projects/:hash/sessions/:id | — | 删除指定会话 |
| PATCH | /projects/:hash/sessions/:id/rename | {name: string} | 重命名会话 |
1.2 实时通信 (LiveWire SSE)
| 方法 | 端点 | 请求体 | 说明 |
|---|---|---|---|
| GET | /live | — | SSE 流式会话事件(实时推送) |
| POST | /live/message | LiveMessageReq (4字段) | 发送用户消息 |
| POST | /live/provider | LiveProviderReq (1字段) | 切换提供商 |
| POST | /live/permission | LivePermissionReq (2字段) | 权限桥接请求 |
| POST | /live/reasoning_effort | LiveReasoningEffortReq | 设置推理努力级别 |
1.3 聊天
| 方法 | 端点 | 请求体 | 说明 |
|---|---|---|---|
| POST | /chat | ChatRequest (5字段) | SSE 流式聊天(主入口) |
| POST | /chat/permission | PermissionDecisionRequest (3字段) | 工具调用权限决策 |
1.4 模型与提供商
| 方法 | 端点 | 请求体 | 说明 |
|---|---|---|---|
| GET | /models | — | 获取可用模型 |
| GET | /providers | — | 获取提供商列表 |
| POST | /providers | CreateProviderRequest (16字段) | 创建提供商 |
| PATCH | /providers/:name | PatchProviderRequest (19字段) | 更新提供商 |
| DELETE | /providers/:name | — | 删除提供商 |
| POST | /providers/:name/default | — | 设为默认提供商 |
| POST | /providers/:name/thinking | PatchThinkingRequest (6字段) | 配置思考设置 |
| POST | /api/provider | CreateProviderRequest (16字段) | Live API 创建提供商 |
| PATCH | /api/provider | PatchProviderRequest (19字段) | Live API 更新提供商 |
| PATCH | /api/thinking | PatchThinkingRequest (6字段) | Live API 更新思考设置 |
1.5 认证
| 方法 | 端点 | 请求体 | 说明 |
|---|---|---|---|
| GET | /auth/status | — | 登录状态 |
| POST | /auth/login/start | — | 发起登录 |
| POST | /auth/login/:id/poll | — | 轮询登录结果 |
| POST | /auth/logout | — | 登出 |
| POST | /oauth/refresh | {refresh_token: string} | 刷新 OAuth token (内部, 非 RESTful) |
1.6 文件系统
| 方法 | 端点 | 请求体 | 说明 |
|---|---|---|---|
| GET | /fs/list?path= | — | 列出目录内容 |
| POST | /fs/mkdir | {path: string} | 创建目录 |
| POST | /cd | {path, set_default} | 更改工作目录 |
1.7 配置
| 方法 | 端点 | 说明 |
|---|---|---|
| GET | /config | 获取配置 |
| POST | /config/reload | 重载配置文件 |
1.8 杂项
| 方法 | 端点 | 说明 |
|---|---|---|
| GET | /skills | 获取 Skills 列表 |
| GET | /tunnel/status | Tunnel 状态 (QR + URL) |
| GET | /mcp/status | MCP 服务器状态 |
| POST | /mcp/reload | 重载 MCP 配置 |
| GET | /health | 健康检查 |
| POST | /shutdown | 关闭 daemon |
| POST | /codingplan/setup | CodingPlan 设置 |
| GET | /issues/?url=<issue_url> | 获取 AtomGit Issue 详情 (fixissue 命令) |
1.9 未公开但二进制中存在的端点
| 方法 | 端点 | 说明 |
|---|---|---|
| POST | /oauth/refresh | OAuth token 刷新 (由 daemon 内部使用) |
| POST | /auth/check | 认证状态检查 (内部) |
| POST | /auth/token | Token 交换 (内部) |
2. WebUI 路由 (port 13457)
2.1 SPA 路由 (均返回 HTML)
| 路径 | 说明 |
|---|---|
/ | WebUI 主页 |
/v1/chat/completions | SPA 路由 → HTML |
/v1/models | SPA 路由 → HTML |
/v1/completions | SPA 路由 → HTML |
/v1/embeddings | SPA 路由 → HTML |
/v1/audio/transcriptions | SPA 路由 → HTML |
/v1/images/generations | SPA 路由 → HTML |
/healthz | SPA 路由 → HTML |
/readyz | SPA 路由 → HTML |
/metrics | SPA 路由 → HTML |
/debug | SPA 路由 → HTML |
/version | SPA 路由 → HTML |
/info | SPA 路由 → HTML |
/status | SPA 路由 → HTML |
/api* | SPA 路由 → HTML |
3. 外部 API
| 端点 | 说明 |
|---|---|
POST https://acs.atomgit.com/api/v1/events | 遥测事件上报 |
GET https://api.gitcode.com/api/v5/models-v2?plan_type=<type> | CodingPlan 模型查询 |
GET https://atomgit.com/atomgit_atomcode/atomcode/releases/latest | 版本检查 |
GET https://atomgit.com/atomgit_atomcode/atomcode/releases/download/<ver>/<bin> | 二进制下载 |
4. OAuth 端点
| 端点 | 说明 |
|---|---|
GET {server}/.well-known/oauth-authorization-server | 授权服务器元数据 |
GET {server}/.well-known/oauth-protected-resource | 受保护资源描述 |
POST {registration_endpoint} | 动态客户端注册 (RFC 7591) |
GET {authorization_endpoint} | 用户授权页面 |
POST {token_endpoint} | Token 交换 |
https://github.com/login/oauth/authorize | GitHub OAuth 授权 |
https://github.com/login/oauth/access_token | GitHub Token 交换 |
📅 最后更新: 2026-06-25🔍 来源: 二进制 strings + WebUI JS 解析 + 运行时抓包