获取文件盒子标签

更新时间：2026-04-15 02:31:41LLM 副本以 Markdown 格式查看下载 PDF

本文介绍获取文件盒子标签的 API。

接口描述

获取文件盒子中已设置的标签信息。该功能旨在简化标签管理，帮助您轻松查找和访问文件盒子中的标签配置。

接口地址

POST: /v1.0/cloud/agent/file/box/user/tags

请求参数

body 说明

参数名	类型	参数位置	是否必填	说明
params	String	body	true	JSON 参数
keyName	String	params	false	标签名
pageNo	String	params	true	页码
pageSize	String	params	true	页面条数

返回参数

参数名	类型	说明
result	CloudDriveQueryTagKeyListResp	返回结果

result 说明

参数名	类型	说明
list	List	标签列表数据
totalCount	Long	总数

list 说明

参数名	类型	说明
tagKey	String	标签名
tagKeyDesc	String	标签描述

请求示例

POST: /v1.0/cloud/agent/file/box/user/tags

{
  "params": "{\"keyName\":\"歌手\",\"pageNo\":1,\"pageSize\":10}"
}

返回示例

{
    "result": {
        "pageSize": 10,
        "list": [
            {
                "tagKeyDesc": "歌手描述",
                "tagKey": "歌手"
            }
        ],
        "totalCount": "0",
        "pageNo": 1,
        "requestId": "732fa027364f4d7b8ab4d2b831fb43ff"
    },
    "success": true
}

错误码

参考错误码。

上一篇文件库检索

下一篇获取音乐资源列表