用途:该资料整理了 Domo Workspace 的逆向工程 REST API,用于把卡片、页面、数据集、数据应用等资产加入工作区,或从工作区移除、列出和搜索内容。Java CLI 没有工作区命令,所有操作需通过 curl 调用 REST API。
主要能力:支持添加单个内容项、移除内容、列出工作区全部内容、列出用户可访问的所有工作区,以及在工作区内搜索内容。添加接口为 POST /nav/v1/workspaces/:guid/contents,请求体形如 {"entityId": "728638278", "entityType": "CARD"};entityType 支持 CARD、PAGE、DATASET、DATA_APP、WORKSPACE_URL。移除使用 DELETE /nav/v1/workspaces/:guid/contents/:contentId,其中 contentId 是工作区内部数字 ID,不是卡片或数据集 ID。列出内容使用 GET /nav/v1/workspaces/:guid/walk?includeDetails=true,列出全部工作区使用 GET /nav/v1/workspaces,搜索使用 POST /nav/v1/workspaces/:guid/addContentQuery。
使用方式:所有请求需在请求头传入 X-DOMO-Developer-Token,令牌可在 Domo 界面 Admin > Security > Access Tokens 生成。基础地址为 https://<instance>.domo.com,路径需包含 /api 前缀,否则返回 404。工作区标识使用 GUID 格式。
限制:该 API 未公开文档,为逆向工程所得,可能随时变化。批量端点 /nav/v1/workspaces/bulk/execute 在测试中返回 400,建议改用单条 /contents 端点。添加响应中的 id 为工作区内部内容 ID,移除时需使用该 ID。资料未提供搜索请求体的具体字段说明。