查看看板图表结果¶

读取图表的最新结果；可通过 at 读取指定时间点之前最近的快照。

GET https://api.moi.matrixorigin.cn/v5/data-dashboards/{dashboard_id}/charts/{chart_id}/result

调用前准备¶

准备有目标工作区访问权限的个人访问令牌和目标工作区 ID，分别通过 X-API-Key 和 X-Workspace-ID 请求头传递。从查看数据看板列表的列表中选择所需数据看板的 ID 作为 $DASHBOARD_ID，再从查看数据看板详情的图表列表中选择所需图表的 ID 作为 $CHART_ID；两者都写入请求路径。

路径参数¶

调用示例

curl -X GET "https://api.moi.matrixorigin.cn/v5/data-dashboards/$DASHBOARD_ID/charts/$CHART_ID/result" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

路径参数

参数	类型	是否必填	说明
dashboard_id	string	是	数据看板 ID。
chart_id	string	是	图表 ID。

查询参数

参数	类型	是否必填	说明
at	string	否	RFC 3339 时间点。

成功响应¶

请求成功时返回图表的最新结果。传入 at 时，返回该时间点之前最近的结果快照。

响应示例

{
  "code": 200,
  "data": {
    "execution_id": "exec-001",
    "status": "completed",
    "mode": "live",
    "result": {
      "total": 1
    }
  }
}

字段说明

通用字段

字段	类型	说明
code	integer	成功时为 200。
data	object	图表结果。

图表结果

下面表格展开响应示例中的 data 对象；每一行是该对象的一个字段。

字段	类型	说明
execution_id	string	图表运行 ID。
status	string	运行或结果状态。
mode	string	结果选择模式。
result	object	查询结果；成功时返回。

错误响应¶

响应示例

{
  "code": 400,
  "message": "请求参数无效"
}

字段说明

字段	类型	说明
`code`	integer 或 string	错误代码或状态码。
`message`	string	错误信息。

最后更新于 2026 年 9 月 11 日