API Reference
控制台管理接口
账号、应用及能力关联的管理接口说明。
鉴权与响应
本页介绍管理接口，与 对外能力调用 分开。管理请求使用 Authorization: Bearer <用户 JWT>，不使用 Access Key；接口校验当前登录用户归属。
常规响应格式为 { code, msg, data }。列表只返回脱敏 Key；明文读取需要独立请求并禁止缓存。
应用接口
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /api/applications?page=1&size=10 | 分页查询自己的应用 |
| POST | /api/applications | 创建应用，返回新 Key |
| GET | /api/applications/:id | 查询详情 |
| PATCH | /api/applications/:id | 编辑名称、描述、能力关联 |
| GET | /api/applications/:id/access-key | 查看完整 Key |
| PATCH | /api/applications/:id/status | 切换 active / disabled |
| DELETE | /api/applications/:id | 删除应用 |
创建与编辑参数
{ "name": "教学助手", "description": "业务用途", "capabilityIds": ["education-ocr"] }创建成功后应妥善保管 Key。编辑时传入的 capabilityIds 是完整能力集合；省略该字段不会调整已有绑定。
能力接口
GET /api/capabilities 查询能力目录；GET /api/capabilities/:id/applications 查询当前用户的应用与绑定状态；PATCH /api/applications/:id/capabilities/:capabilityId 幂等追加能力关联。
权限边界
不可读取或操作其他用户的应用。用户 JWT 仅管理控制台资源，业务服务调用能力时仍需应用 Key。参见 应用管理。