求Superset REST API创建图表/仪表盘的详细文档（含payload字段说明）

由于Superset官方API文档对这两个字段的细节说明不足，你可以通过以下几种方式深入理解它们的含义：

• 直接查看源码定义
  Superset的源码是最权威的参考，这两个字段的结构在核心模型中有明确定义：

  • params：对应图表的可视化配置参数，不同图表类型（如折线图、柱状图）的params结构差异很大，你可以在superset-frontend/src/visualizations目录下找到对应图表类型的配置Schema，里面会列出所有支持的参数（比如metric指定聚合指标、groupby指定分组字段、row_limit限制返回行数等）。
  • query_context：负责定义数据查询的核心上下文，包含数据源信息、查询过滤条件、聚合规则等。它的结构可以在superset/common/query_context.py文件中找到，核心子字段包括：
    • datasource：指定查询的数据源ID和类型（如table或dataset）
    • queries：数组形式，每个元素对应一个具体的查询请求，包含metrics（聚合指标）、columns（查询字段）、filters（过滤条件）、time_range（时间范围）等关键配置

• 通过Swagger UI查看字段说明
  在你的Superset实例内部，访问/api/v1/swagger页面，找到POST /api/v1/chart接口的请求体定义，里面会对params和query_context的子字段做基础说明，部分字段会标注类型和可选值。

• 反向调试验证
  你可以尝试修改payload中的字段值，比如调整params里的row_limit或query_context里的time_range，然后调用API查看返回的图表数据或UI渲染结果的变化，反向推导字段的作用。

• 参考社区讨论
  在Superset的GitHub Discussions或Issues中搜索params query_context关键词，部分核心开发者会在相关问题里解释字段的设计逻辑和使用场景，也能找到其他用户分享的实战案例。

内容的提问来源于stack exchange，提问作者qikangchen-fhf