HTTP OpenAPI
HTTP OpenAPI
控制面 8090 HTTP API 按业务场景组织：命名空间、服务、实例、配置与治理规则。
HTTP API 由 api-http 插件提供，默认监听 8090。按场景选择子文档；每页采用左参数 / 右多语言示例布局。
场景目录
| 场景 | 说明 |
|---|---|
| 鉴权 | |
| 登录与状态 | 登录 / system |
| 用户 | 用户 CRUD 与 Token |
| 用户组 | 用户组 CRUD |
| 角色 | 角色 CRUD |
| 策略 | 策略与资源授权 |
| 管理面 Admin | 运维管理接口 |
| 命名空间 | 环境 Namespace |
| 服务 | |
| 服务 · 基本信息 | 服务 CRUD |
| 服务 · 契约 | 契约查询与上报 |
| 服务 · 调用拓扑 | 订阅者 / 调用关系 |
| 服务 · 实例 | 实例注册与管理 |
| 配置 | |
| 配置分组 | Config group |
| 配置文件 | 文件读写 |
| 配置灰度 | normal / gray 发布 |
| 配置模板 | Config templates |
| 治理 | |
| 路由 | 路由规则 |
| 限流 | 限流规则 |
| 熔断 | 熔断规则 |
| 故障探测 | 主动探测 |
| 泳道 | 泳道规则 |
| 无损上下线 | 无损规则 |
| 流量鉴权 | 调用鉴权 |
| 流量镜像 | 镜像规则 |
| 流量 Mock | Mock 规则 |
| AI Registry | |
| MCP Registry | MCP Server / Tool |
| A2A Registry | A2A Agent / Skill |
| 客户端接口 | Discover / Register / 拉配置 |
使用约定
| 项 | 说明 |
|---|---|
| Base URL | http://127.0.0.1:8090 |
| 管理面鉴权 | Authorization（登录返回的 token） |
| 分组开关 | api-http.api.{console,client,admin,aimcp,aia2a} |
| 写接口 body | 多为 protobuf 消息数组 [{...}]；文档列出单条对象的完整字段树（含嵌套 children） |
| 嵌套结构 | rules / routing_config / health_check 等已按 specification 展开；Any 类型按策略列出可 unpack 的消息 |
| 响应字段 | 写接口同步列出实体响应字段树；示例 JSON 见右侧 |
参数与路径对照控制面 httpserver Enrich 注解与 specification protos；运行时以服务端为准。