/api/v1/system/version公开REST API
API 参考
所有官网与控制台用到的接口都是公开的 REST,base URL 见下。
BorderCollie 控制台猫狗试验室
已同步API 调用面板公开接口、登录态接口、CLI Key
/api/v1/review/scan登录态/api/v1/cli/whoamiAPI Key base url
https://review.woofcloud.com/api/v1需要鉴权的接口请在请求头加 Authorization: Bearer <access_token>;登录返回的 access_token 有效期 2 小时,可用 /api/v1/token/** 续期。
公开接口
| POST | /api/v1/user/register | 用户注册(邮箱或手机号) |
| POST | /api/v1/captcha/send | 发送邮箱/短信验证码 |
| GET | /api/v1/system/version | 系统版本信息(changelog 数据源) |
| GET | /api/v1/announcement/public/page | 官网公告分页查询 |
| GET | /api/v1/announcement/public/:slug | 官网公告详情 |
| GET | /api/v1/subscription/plans | 公开套餐目录 |
| POST | /api/v1/webhook/:platform | 统一 Webhook 入口(platform=github/gitlab/gitee/cnb) |
登录态接口
| POST | /api/v1/login | 账号密码登录 |
| GET | /api/v1/menu | 当前用户菜单 / 权限 |
| POST | /api/v1/review/repo | 保存仓库配置 |
| GET | /api/v1/review/task/page | 审查任务分页查询 |
| POST | /api/v1/review/scan | 触发一次仓库扫描 |
CLI 与 CI 接入
| GET | /api/v1/cli/whoami | CLI:查询当前 API Key 绑定的租户与套餐 |
| GET | /api/v1/cli/repo/list | CLI:列当前租户的仓库 |
| POST | /api/v1/cli/repo | CLI:新建或更新仓库 |
| DELETE | /api/v1/cli/repo/:id | CLI:删除仓库 |
| PUT | /api/v1/cli/repo/:id/toggle | CLI:切换仓库启用状态 |
| GET | /api/v1/cli/model/list | CLI:列模型 |
| POST | /api/v1/cli/model | CLI:新建或更新模型 |
| PUT | /api/v1/cli/model/:id/default | CLI:设为默认模型 |
| GET | /api/v1/cli/agent/list | CLI:列已启用的审查角色 |
| PUT | /api/v1/cli/agent/:id/toggle | CLI:切换审查角色启用状态 |
| GET | /api/v1/cli/reviewer/list | CLI:列审核人员(含内置预设) |
| POST | /api/v1/cli/review/submit | CLI:提交本地 diff 跑一次审查 |
| POST | /api/v1/cli/review/branch | CLI:让后端拉 base..branch 的 diff 跑审查 |
| GET | /api/v1/cli/review/status/:id | CLI:查询任务简洁状态 |
| GET | /api/v1/cli/review/result/:id | CLI:查询任务详细结果(含 findings) |
| GET | /api/v1/cli/review/list | CLI:最近任务分页 |
| POST | /api/v1/cli/review/:id/retry | CLI:重试失败任务 |
| GET | /api/v1/cli/usage | CLI:查看当前租户的配额与用量 |
| GET | /api/v1/cli/plans | CLI:列出对外公开的套餐目录 |
| GET | /api/v1/cli/logs/page | CLI:模型调用日志分页 |
CLI 与 CI 通过请求头 X-API-Key 鉴权;API Key 在控制台「API Key」页签生成,按租户隔离。
更详细的字段约束、错误码与示例请见 /docs
