Skip to main content
除特别说明外,所有产品 API 都使用 /api/v1 前缀。本目录按当前路由家族分组;具体示例页面说明常见请求。

授权模型

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

事实来源

维护中的 OpenAPI 文件位于 molesignal/docs/api/openapi.yaml。部分快速演进的功能在 src/api/http/routes/ 中拥有比精简 OpenAPI 概览更多的路由。两者不一致时,以服务器路由和 Handler 契约为准,并应在同一变更中更新文档。

API 入门

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