mirror of
https://github.com/EZ-Api/ez-api.git
synced 2026-01-13 17:47:51 +00:00
6cab7e257a
- Add dashboard alerts, realtime, and apikey-stats endpoints - Document time range parameters for logs and apikey-stats - Update daily operations workflow with new monitoring endpoints - Clarify period parameter behavior (default returns all data)
4.2 KiB
4.2 KiB
Admin Panel Mapping (Admin API)
本表用于前端管理面板的「页面与接口对照」与基础交互流程说明。
鉴权统一使用：Authorization: Bearer <EZ_ADMIN_TOKEN>。
页面与接口对照表
| 页面 | 接口 | 交互要点 |
|---|---|---|
| Dashboard / 全局概览 | GET /admin/dashboard/summary GET /admin/realtime GET /admin/stats |
聚合指标、实时 QPS、传统统计 |
| Dashboard / 告警 | GET /admin/alerts GET /admin/alerts/stats POST /admin/alerts/:id/ack POST /admin/alerts/:id/resolve |
告警列表、统计、确认、解决 |
| Dashboard / 上游凭证统计 | GET /admin/apikey-stats/summary |
上游 API Key 成功率统计，支持时间范围 |
| 操作日志 | GET /admin/operation-logs |
管理员操作审计 |
| 租户（Masters）列表 | GET /admin/masters POST /admin/masters POST /admin/masters/batch |
列表 + 批量操作 |
| 租户详情 | GET /admin/masters/:id PUT /admin/masters/:id DELETE /admin/masters/:id |
查看/编辑/删除 |
| 租户实时监控 | GET /admin/masters/:id/realtime |
实时 QPS/用量 |
| 租户状态管理 | POST /admin/masters/:id/manage |
冻结/解冻/状态切换 |
| 租户访问权限 | GET /admin/masters/:id/access PUT /admin/masters/:id/access |
设置 namespaces/能力 |
| 子 Key 颁发 | POST /admin/masters/:id/keys |
发放子 Key |
| 子 Key 权限 | GET /admin/keys/:id/access PUT /admin/keys/:id/access |
Key 级别访问控制 |
| Namespaces | GET /admin/namespaces POST /admin/namespaces GET /admin/namespaces/:id PUT /admin/namespaces/:id DELETE /admin/namespaces/:id |
命名空间 CRUD |
| Provider Groups | GET /admin/provider-groups POST /admin/provider-groups GET /admin/provider-groups/:id PUT /admin/provider-groups/:id DELETE /admin/provider-groups/:id |
上游组定义 |
| API Keys | GET /admin/api-keys POST /admin/api-keys GET /admin/api-keys/:id PUT /admin/api-keys/:id DELETE /admin/api-keys/:id POST /admin/api-keys/batch |
group_id 过滤、批量操作 |
| Bindings | GET /admin/bindings POST /admin/bindings GET /admin/bindings/:id PUT /admin/bindings/:id DELETE /admin/bindings/:id POST /admin/bindings/batch |
bindingKey -> group_id，多候选 + weight |
| Models | GET /admin/models POST /admin/models PUT /admin/models/:id DELETE /admin/models/:id POST /admin/models/batch |
模型能力表 |
| Feature Flags | GET /admin/features PUT /admin/features |
DP 开关、日志策略等 |
| Model Registry | GET /admin/model-registry/status POST /admin/model-registry/check POST /admin/model-registry/refresh POST /admin/model-registry/rollback |
外部模型注册表 |
| 日志查询 | GET /admin/logs DELETE /admin/logs |
查询/清理 |
| 日志统计 | GET /admin/logs/stats |
日志统计视图 |
| 日志 Webhook | GET /admin/logs/webhook PUT /admin/logs/webhook |
告警配置 |
| 同步快照 | POST /admin/sync/snapshot |
手动触发 CP -> Redis |
交互流程
上游配置上线
POST /admin/provider-groups创建 ProviderGroup。POST /admin/api-keys绑定 key（必要时多条）。POST /admin/bindings建立bindingKey = namespace.public_model -> group_id（可多条绑定 + weight）。POST /admin/models或POST /admin/model-registry/refresh更新能力表（能力校验基于 bindingKey）。
租户开通
POST /admin/masters创建租户。PUT /admin/masters/:id/access设置可见 namespaces。POST /admin/masters/:id/keys签发子 Key。PUT /admin/keys/:id/access细化 Key 的访问范围（可选）。
日常运维
GET /admin/logs+GET /admin/logs/stats查询异常与用量（支持group_by=hour|minute）。PUT /admin/logs/webhook配告警；DELETE /admin/logs清理。GET /admin/dashboard/summary、GET /admin/realtime、GET /admin/masters/:id/realtime查看实时指标。GET /admin/alerts+GET /admin/alerts/stats查看系统告警；POST /admin/alerts/:id/ack确认告警。GET /admin/apikey-stats/summary查看上游凭证成功率（支持since/until时间范围）。PUT /admin/features调整 DP 开关；必要时POST /admin/sync/snapshot手动同步。