更新看板图表完整顺序

PATCH /data-dashboards/{dashboard_id}/chart-order,工作区由单个非空X-Workspace-ID确定。请求仅需chart_ids数组,但handler为普通单次JSON解码,不像下钻一样拒绝未知字段/第二个JSON值;不要混写严格程度。

请求参数

{"chart_ids":["chart-b","chart-a"]}

字段

类型

约束

chart_ids

array(字符串数组)

必须显式提供,非null;完整非deleted图表ID排列,非部分移动列表

service检查每个ID非空、无首尾空白;DAO在同租户事务内锁active看板和全部非deleted图表,要求数量一致、无重复、无外来ID。pending或deleting图表拒绝排序并映射409/ErrDataDashboardOperationActive。每张图表原layout_config字段保留,只将order设为从0开始的索引;未改变布局的不更新。不是重建图表或调整SQL。

成功响应

成功为code/msg/data封套,data.chart_ids回显顺序。空看板显式[]可经过校验,但service复制空切片后回显可能为null;不能据回显推导删除图表。省略/null输入映射400/ErrParamInvalid,非法排列同样400,缺对象404/ErrDataDashboardNotFound,权限/依赖沿看板错误映射。响应不提供并发版本,提交前重新读详情以免使用旧排列;

Go SDK及CLI当前把显式空数组省略成{},Python保留[],详见SDK差异;没有把三者记成整个排序能力缺失。

最后更新于