POST管理接口

指标 DSL 求值

查询构建器与看板卡片共用的执行入口。按结构化的指标定义计算趋势、分布或者单值，支持按属性筛选、按维度分组，以及 `A / B * 100` 形式的跨事件公式。公式在服务端由一个只认「别名、数字、+ - * / ( )」的解析器求值，不使用 eval，也不下推到 SQL；属性条件一律编译成参数化查询。只读接口，用 POST 的理由同漏斗；所需权限是 events:read。

URL

/api/v1/admin/projects/{projectKey}/events/analysis/query

鉴权方式

需要管理员 JWT 或 API Key，二者等价（Authorization: Bearer <token>）

请求参数

Path 参数

名称	类型	必填	说明
projectKey	string	是	项目主键 project_key（大小写不敏感）

Header 参数

名称	类型	必填	说明
Authorization	string	是	Bearer <管理员 JWT 或 API Key>

请求体

{
  "type": "value",
  "events": [
    {
      "name": "checkout_completed",
      "alias": "A",
      "measure": "unique_users"
    },
    {
      "name": "cart_viewed",
      "alias": "B",
      "measure": "unique_users"
    }
  ],
  "formula": "A / B * 100"
}

响应示例

200 响应

{
  "start_time": 0,
  "end_time": 0,
  "type": "timeseries",
  "series": [
    {
      "key": "string",
      "data": [
        {
          "bucket": 1760000000,
          "count": 42
        }
      ]
    }
  ],
  "total": 0,
  "buckets": [
    {
      "key": "string",
      "label": "string",
      "count": 0
    }
  ],
  "values": {},
  "result": 0
}

POST

鉴权方式

请求参数

响应示例

Try It Out