API概览

本产品(quickbi-public/2022-01-01)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明。我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(147535001692),在专家指导下进行签名对接。

在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

组织管理

API

标题

API概述

组织用户管理 组织用户管理
CheckOrganizationMember 判断用户是否属于组织 判断用户是否属于组织。
CreateCubeBySql 根据自定义sql创建数据集 根据自定义sql创建数据集。
AddUser 添加组织成员 添加组织成员。
BatchAddFeishuUsers 批量添加飞书用户 批量添加飞书用户。
DeleteUser 删除组织用户 删除指定组织用户。
UpdateUser 更新组织成员信息 更新组织下指定成员的信息。
QueryUserList 查询组织成员列表信息 查询组织成员列表信息。
QueryUserInfoByUserId 根据用户ID查询用户信息 根据用户ID查询用户信息。
QueryUserInfoByAccount 根据账号查询用户信息 根据阿里云ID或阿里云账户名查询用户信息。
组织用户组管理 组织用户组管理
CreateUserGroup 新建用户组 新建用户组,可以指定父用户组。
AddUserGroupMember 添加成员到用户组 将组织成员添加到指定的用户组。
AddUserGroupMembers 批量添加成员到用户组 将用户批量添加到指定的用户组中。
DeleteUserGroup 删除用户组 删除组织内的用户组。
DeleteUserGroupMember 删除用户组成员 删除指定用户组下的指定成员。
DeleteUserGroupMembers 用户批量退出用户组 指定用户批量退出用户组。
WithdrawAllUserGroups 用户退出所有用户组 使用户退出所有用户组,该过程不可逆,请谨慎操作。
UpdateUserGroup 更新用户组信息 更新组织下指定用户组的信息。
GetUserGroupInfo 根据关键字获取用户组信息 根据用户组名称关键字搜索用户组信息。
ListByUserGroupId 批量查询用户组 根据用户组ID批量查询用户组信息。
ListUserGroupsByUserId 查询用户所属的用户组信息列表 根据用户的UserID,查询该用户所属的所有用户组信息。
QueryUserGroupListByParentId 查询父用户组下的子用户组列表 获取指定父用户组下的子用户组信息。
QueryUserGroupMember 查询用户组成员列表 获取用户组下的成员列表信息。
用户标签管理 用户标签管理
AddUserTagMeta 新增组织成员标签元信息 新增组织成员标签元信息。
DeleteUserTagMeta 删除组织成员标签元信息 删除组织成员的标签元信息。
UpdateUserTagValue 更新组织成员标签值 更新组织成员标签值。
QueryUserTagMetaList 查询组织成员标签元信息列表 查询组织内成员标签元信息列表。
QueryUserTagValueList 查询组织成员标签值列表 查询特定用户标签值列表。
UpdateUserTagMeta 更新组织成员标签元信息 用于更新组织成员标签元信息。
角色管理 角色管理
ListWorkspaceUserRolesByUserId 查询用户所有空间角色列表 查询用户所有空间角色列表。
ListWorkspaceRoleUsers 获取指定空间角色下的用户列表 获取指定空间角色下的用户列表。
QueryWorkspaceRoleConfig 获取指定空间角色的配置信息 获取指定空间角色的配置。
QueryOrganizationRoleConfig 获取指定组织角色的配置信息 获取指定组织角色的配置。
ListWorkspaceRoles 获取空间角色列表 获取空间角色列表。
ListOrganizationRoles 获取组织角色列表 获取组织角色列表。
ListOrganizationRoleUsers 获取指定组织角色下的用户列表 获取指定组织角色下的用户列表。

权限管理

API

标题

API概述

报表分享授权管理 报表分享授权管理
AddShareReport 添加数据作品分享配置 添加数据作品的一个分享配置。
CancelReportShare 删除数据作品的分享授权 删除数据作品的一个分享授权。
QuerySharesToUserList 查询授权给用户的作品列表 查询授权给用户的作品列表。
QueryShareList 查询作品的分享记录 查询作品被分享给哪些对象的列表,只返回仍然在有效期限内的分享配置。
数据门户菜单授权管理 数据门户菜单授权管理
AuthorizeMenu 数据门户菜单批量授权 数据门户菜单的批量授权,已经授权的会自动略过。
CancelAuthorizationMenu 批量取消数据门户菜单授权 根据门户菜单ID,取消指定用户、用户组的授权记录。
ChangeVisibilityModel 修改数据门户菜单的可见方式 修改数据门户菜单的可见方式,是否仅授权可见。
ListPortalMenus 获取数据门户菜单列表 获取具体数据门户下的分层菜单列表。
ListPortalMenuAuthorization 获取数据门户菜单的授权详情 获取数据门户菜单的授权详情列表。
行级权限管理 行级权限管理
SetDataLevelPermissionRuleConfig 设置单条数据集行列权限配置信息 设置单条数据集行列权限配置信息(新增和更新)。
AddDataLevelPermissionRuleUsers 添加行列权限规则人群 针对单条行列权限规则增量添加选定的人群。
AddDataLevelPermissionWhiteList 增量修改行列权限白名单 修改指定数据集行列权限的白名单。
DeleteDataLevelRuleConfig 删除行列权限规则 删除单条行列权限规则。
DeleteDataLevelPermissionRuleUsers 删除行列规则的人群 针对单条行列权限规则删除选定的人群。
UpdateDataLevelPermissionStatus 更新数据集行列权限开关状态 更新数据集行列权限开关状态。
SetDataLevelPermissionExtraConfig 设置行列权限额外配置 设置行列权限的额外配置。
SetDataLevelPermissionWhiteList 设置行级权限白名单 设置指定行级权限的白名单列表。
QueryDatasetSwitchInfo 获取数据集行级权限开关状态 获取指定数据集的行级权限开关状态。
ListCubeDataLevelPermissionConfig 获取数据集行列权限配置列表 获取指定数据集的行列权限配置列表。
ListDataLevelPermissionWhiteList 获取数据集行列权限白名单列表 根据行列权限种类,获取数据集行列权限的白名单列表。
开放审批 开放审批
QueryApprovalInfo 根据审批人获取相应的审批流信息 根据审批人获取相应的审批流信息。
ResultCallback 自定义审批流回调接口 自定义审批流回调接口,用户自行对Quick BI的审批流进行处理。

资源管理

API

标题

API概述

报表资源管理 报表资源管理
UpdateEmbeddedStatus 更改报表的嵌入状态 更改报表的嵌入状态,开通嵌入、或者关闭嵌入。
QueryWorksByOrganization 查询组织下的所有作品 查询整个组织下的所有作品,可指定作品类型。
QueryWorksByWorkspace 查询工作空间下的所有作品 查询组织下某个工作空间下的所有作品,可指定作品类型。
QueryReadableResourcesListByUserIdV2 查询用户有权查看的作品列表(新) 查询用户有权查看的作品列表(新)。
QueryReadableResourcesListByUserId 查询用户有权查看的作品列表 查询用户有权查看的作品列表,包含空间下与分享授权的报表。
CheckReadable 查询用户对数据作品的查看权限 查询用户对数据作品(仪表板、电子表格等)是否有权限查看。
QueryEmbeddedInfo 获取组织嵌入配置 获取组织下的嵌入配置,包括最大嵌入数和已经嵌入数等。
QueryEmbeddedStatus 查询报表嵌入状态 查询某个报表是否已经开通嵌入。
QueryWorks 查询数据作品信息 查询指定数据作品信息。
QueryWorksBloodRelationship 查询数据作品的血缘信息 获取数据作品的血缘关系,包括各组件引用的数据集以及查询字段信息。目前仅支持的数据作品包含仪表板、电子表格、自助取数。
QueryComponentPerformance 查询组件性能日志 查询组件性能日志。
QueryReportPerformance 查询报表性能日志 查询报表性能日志。
GetWorksEmbedList 获取已经嵌入的报表 查询已嵌入报表列表。
数据集资源管理 数据集资源管理
CheckDatasetExisted 检查给定的cubeId是否存在 检查给定的cubeId是否存在。
CreateDataset 根据物理表名称创建数据集 根据物理表名称创建数据集。
AddDataSource 新增数据源连接 新增数据源连接信息。
UpdateDataSource 修改数据源配置 修改数据源配置。
UpdateCubeBySql 更新自定义sql数据集 更新自定义sql数据集。
QueryLastAccelerationEngineJob 通过数据集ID查询最近一次加速任务 通过数据集ID查询最近一次加速任务。
ListDataSource 查询指定空间下的所有数据源 查询指定空间下的所有数据源。
DataSetBlood 查询引用指定数据集下的作品信息 查询引用指定数据集下的作品信息。
DataSourceBlood 查询引用指定数据源下的数据集信息 查询引用指定数据源下的数据集信息。
ModifyApiDatasourceParameters 修改API数据源配置 修改指定API数据源的配置。
ListApiDatasource 查询API数据源列表 查询API数据源列表。
QueryDatasetInfo 查询数据集信息 查询指定数据集的信息。
QueryDatasetDetailInfo 查询数据集详情 查询指定数据集的详情,包括所属数据源、目录、以及数据集模型。
QueryDatasetList 查询工作空间数据集列表 查询指定工作空间的数据集列表,按照创建时间倒序排列。
AllotDatasetAccelerationTask 触发数据集抽取加速 触发数据集Quick引擎的采集加速。
QueryCubePerformance 查询数据集性能日志 查询数据集性能日志。
QueryCubeOptimization 查询数据集优化建议 查询数据集优化建议。
GetDataSourceConnectionInfo 获取数据源信息 获取数据源信息。
ListAccelerationOfWorkspace 获取空间下加速引擎管控页任务信息 获取空间下加速引擎管控页任务信息。
QueryAccelerationLogByCubeId 获取指定数据集的加速任务运行日志 获取指定数据集的加速任务运行日志。
工作空间管理 工作空间管理
AddUserToWorkspace 添加成员到工作空间 添加成员到指定工作空间。
AddWorkspaceUsers 批量添加成员到工作空间 批量添加成员到工作空间。
DeleteUserFromWorkspace 删除工作空间成员 删除指定工作空间的成员。
UpdateWorkspaceUsersRole 批量更新工作空间成员的角色 批量更新工作空间成员的角色信息,已有角色会被覆盖。
UpdateWorkspaceUserRole 修改工作空间成员角色 修改工作空间下指定成员的角色,已有的角色会被覆盖。
QueryWorkspaceUserList 查询工作空间下的成员列表 查询指定工作空间下的成员列表信息。
QueryOrganizationWorkspaceList 获取组织下的工作空间列表 获取当前组织下的工作空间列表信息。
QueryUserRoleInfoInWorkspace 查询工作空间成员的预置角色 获取指定工作空间成员的预置空间角色信息。
CreateWorkspace 新建工作空间 新建工作空间。
收藏管理 收藏管理
SaveFavorites 添加作品收藏 添加用户的收藏数据作品。
CancelCollection 取消作品收藏 取消用户收藏的数据作品。
ListCollections 获取用户收藏作品列表 获取用户收藏的作品列表。
首页管理 首页管理
ListFavoriteReports 首页看板收藏列表 获取指定用户在首页看板中展示的收藏作品列表。
ListRecentViewReports 获取首页看板常看和足迹列表 获取指定用户在首页看板中展示的常看和足迹列表。
ListSharedReports 获取首页看板被授权的作品列表 获取指定用户在首页看板中展示的被授权的作品列表。
订阅管理 订阅管理
ManualRunMailTask 手动执行邮件任务 手动执行订阅的邮件任务。
GetMailTaskStatus 查看邮件任务运行状态 查看组织内邮件任务运行状态(实时状态非最终状态)。

数据管理

API

标题

API概述

数据服务 数据服务
QueryData 查询数据 对数据服务中已创建的API进行调用。
QueryDataServiceList 数据服务列表API 查询数据服务API列表。
QueryDataService 调用数据服务API 对数据服务中已创建的API进行调用。

嵌入分析

API

标题

API概述

报表嵌入 报表嵌入
CreateTicket 生成报表嵌入ticket 生成报表嵌入需要使用的ticket。
DeleteTicket 删除嵌入ticket 删除免登嵌入报表的指定ticket。
DelayTicketExpireTime 更新嵌入ticket的失效时间 更新嵌入报表的ticket的失效时间。
UpdateTicketNum 更新嵌入ticket票据数量 对用于免登嵌入报表的指定的ticket进行更新票据数量操作。
QueryTicketInfo 查询嵌入报表ticket详情 获取免登嵌入报表的指定ticket的详情信息。

统计分析

API

标题

API概述

资源分析 资源分析
QueryAuditLog 查询审计日志信息 查询审计日志信息。

智能问数

API

标题

API概述

智能问数嵌入 智能问数嵌入
CreateTicket4Copilot 生成智能小Q嵌入Ticket 用于生成智能小Q嵌入Ticket。
ModifyCopilotEmbedConfig 修改智能问数嵌入配置 修改智能问数嵌入配置。
QueryCopilotEmbedConfig 获取开通小Q嵌入的配置列表 获取开通小Q嵌入的配置列表。
QueryDataRange 获取数据范围目录列表 获取嵌入配置界面的数据范围目录列表。
智能问数管理 智能问数管理
ModifyDashboardNl2sqlStatus 批量编辑仪表板的小Q问数状态 批量编辑仪表板的小Q问数状态。
QueryDashboardNl2sql 查询仪表板的问数资源信息 查询仪表板的问数资源信息。
SmartqAuthorize 批量管理小Q问数的授权 批量管理小Q问数的授权。
QueryLlmCubeWithThemeListByUserId 查看用户有哪些数据集和分析主题的问数授权 查看用户有哪些数据集和分析主题的问数授权。
SmartqAuthTransfer 将指定用户的问数权限同步给其他用户 将指定用户的问数权限同步给其他用户。
QuerySmartqPermissionByCubeId 查看用户是否有某个小Q问数数据集权限 查看用户是否有某个小Q问数数据集权限。
QueryDatasetSmartqStatus 查看数据集是否开通小Q问数 查看数据集是否开通小Q问数。
SmartqQueryAbility Q问数查询 Q问数查询。