资产与安全 API
本页资产接口使用 ASSETS_BASE_URL=https://<host>/assets；分类分级与安全资产接口使用 DATASECURITY_BASE_URL=https://<host>/datasecurity。
企业门户通常需要展示目录、业务含义、权属、数据管家及安全提示。目录浏览权、资产详情权、底层数据访问权分别处理；API 查询不应绕过发布和授权流程。
资产目录与详情
| 方法与路径 | 关键输入 | 用途 |
|---|---|---|
GET /assets/catalog/structures | Query：fromPage（String，必填，取值需按目标入口确认） | 查询可展示的目录结构，返回 id、name、访问及发布配置等 |
GET /assets/catalog/browse/{structureId}/{catalogId} | Path：structureId、catalogId（Long） | 浏览目录；返回目录数组，不是分页资产清单 |
POST /assets/catalog/subCatalog | Body：catalogId（Long，必填）、isManagement、status（数组） | 获取子目录；状态可为 UNPUBLISHED、UNDER_REVIEW、PUBLISHED、OFFLINE |
GET /assets/catalog/detail/{id} | Path：目录 id（Long） | 获取目录详情，外层为 status、msg、data |
POST /assets/assets/list | Body：structureId、catalogId、pageNum、pageSize；可选 assetsName、range | 查询资产列表；range 为 LIST、BROWSE、MY |
GET /assets/assets/detail/{catalogId}/{objectId} | Path：catalogId、底层 objectId（Long） | 获取资产详情，包括 assetId、权属、管家、定义、标准和安全信息 |
资产列表的请求采用 SearchDto，外层响应为 status、msg、data，其中 data 是开放 Map。本文不编造它的分页列表字段。联调时应核对目标环境实际返回、分页起始值和发布状态筛选值。
在面向业务使用者的门户中选择浏览范围，保留已发布与当前身份可见的对象。不要通过管理范围、客户端传入其他用户名，或 noRight 等字段尝试扩大访问。服务端仍须校验调用身份与对象范围。
资产详情关注什么
DataAssetDetailDto 定义包含 assetId、assetCode、modelId、definition、department、dataManager、domains、securityLevel、securityCatalog 等。接入方可将其组织为业务资产卡片。
返回里的 assetId 不能替代接口路径需要的底层 objectId。同一底层对象可能被不同目录组织，跨系统应保留“目录结构、目录、资产、底层对象”的对应关系。
分类分级与识别结果
以下路径同样包含服务前缀及控制器的 /datasecurity，两者都须保留。
| 方法与路径 | 关键输入 | 用途 |
|---|---|---|
GET /datasecurity/datasecurity/catalog/search | Query：keywords（String，必填） | 检索安全分类目录 |
GET /datasecurity/datasecurity/catalog/classify/{catalogId} | Path：catalogId（Long） | 查询安全分类详情；当前响应为开放对象 |
POST /datasecurity/datasecurity/check/search/publishassets | Body：assetName、categoryId、modelId、schema、tagId、pageNo、pageSize | 查询已发布安全资产，tagId 为安全等级 ID |
POST /datasecurity/datasecurity/result/get | Body：taskId、modelId、tableId、ruleId、pageNum、pageSize 等 | 查询识别结果，用于审核和治理跟踪；不是默认的已发布安全结论 |
例如查询某个获准范围的已发布安全资产：
{
"pageNo": 1,
"pageSize": 20,
"modelId": 1001,
"schema": "demo_sales"
}1001 和 Schema 为示例。安全接口外层返回 status、msg、data，实际资产字段按部署返回核对。不能把识别建议直接当作已经审核的分类分级，也不能用“没有查到记录”推断某数据不敏感。
场景：在门户显示资产安全提示
- 取得当前身份有权浏览的目录与资产，保存底层对象及目录标识。
- 查询资产详情中的定义、责任部门、数据管家和安全信息。
- 需要进一步展示分类分级依据时，读取安全分类及已发布安全资产。
- 对缺少评审、无权限或返回为空的对象保留明确的业务状态，由相应责任人补齐；不输出“可自由使用”等无依据结论。
- 使用申请仍走资产申请与审批，实际数据交付和网关授权按组织流程处理。
分类分级结果与数据安全网关中的运行策略分开管理。读取一个“敏感”等级不代表所有 JDBC、API 或直连数据库路径已经应用脱敏。
本页接口在此次工作中核对了 OpenAPI 定义，未修改目录、处理识别建议或改变访问策略。fromPage、开放 Map 和分页细节需在客户部署环境做样本联调后固定。