使用ListTags API列举标签分组-网盘与相册服务-阿里云-网盘与相册服务(PDS)-阿里云帮助中心

接口说明

标签分组接口结果是一次性返回指定的 drive 内聚合的结果，按照分组内照片数取前 top2000 个返回。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/image/list_tags HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
domain_id	string	是
body	object	否	请求体参数。
drive_id	string	是	空间 id	1
image_thumbnail_process	string	否	图片缩略图处理	image/resize,w_200
video_thumbnail_process	string	否	视频缩略图处理	video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast

返回参数

名称	类型	描述	示例值
	object
tags	array	分组列表
	ImageTag	标签信息

示例

正常返回示例

JSON格式

{
  "tags": [
    {
      "name": "动物",
      "count": 1,
      "cover_url": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
      "cover_file_id": "5d79206586bb5dd69fb34c349282718146c55da7",
      "cover_file_category": "image",
      "cover_tag_confidence": 1,
      "cover_overall_score": 0.736
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。