跳转到主要内容
除特别说明外,所有产品 API 都使用 /api/v1 前缀。本目录按当前路由家族分组;具体示例页面说明常见请求。

授权模型

端点可以要求:
  • streams.query 或 alerts.manage 等组织权限;
  • sys.telemetry.read 等平台权限;
  • 资源级所有权或关系/授权;
  • 仅能访问一个资源的公开共享会话。
不要根据展示角色推断授权。请查询 /api/v1/iam/capabilities 获取实际生效的权限与功能快照。

事实来源

本参考记录各路由族的常见请求。源代码仓库中 src/api/http/routes/ 下的处理逻辑定义了每条路由的契约,包括没有示例页面的路由。该仓库 docs/api/openapi.yaml 中的 OpenAPI 概览只覆盖了部分接口。文档与处理逻辑不一致时,以处理逻辑为准。

API 入门

了解基础 URL、Bearer 身份验证、分页、错误与请求约定。
最后修改于 2026年10月26日