开发者社区> 问答> 正文

云相册的API标签接口ListTags怎么使用



描述


全量列出当前照片库中照片的标签列表

请求参数

参数名类型是否必须说明
ActionStringListTags
StoreNameStringPhotoStore的名称
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


请求示例https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListTags
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>





返回参数

参数名类型说明
RequestIdString唯一标识本次请求的ID
CodeString响应状态码,Success表示成功的响应
MessageString响应状态详细描述
ActionStringListTags
TagsTag[]Tag数组


Tags

参数名类型说明
Cover对象标签的封面照片
IdString标签的唯一标识
IsSubTagBoolean是否为二级标签,true 是二级标签,false 不是二级标签
ParentTagString一级标签,IsSubTag 是 true 时,输出当前 tag 的一级标签; 为 false 时,即当前 tag 为一级标签,输出空字符串
NameString标签的名称


Cover

参数名类型说明
CtimeString创建的时间戳,单位:毫秒
FileIdString照片对应到存储在OSS上的文件名
HeightInteger照片的高度
IdLong记录的唯一标识
Md5String文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。
MtimeString最后修改的时间戳,单位:毫秒
RemarkString照片的备注
StateString文件的状态
TitleString照片的名称
WidthInteger照片的宽度


返回示例


JSON格式 {
    "Tags":[
        {
            "Name":"舞蹈",
            "Id":36864,
            "IsSubTag":false,
            "ParentTag":"",
            "Cover":{
                "Md5":"ac9cc6c68ae7f76d835e110a797baa14",
                "Mtime":1500522991107,
                "State":"active",
                "Height":201,
                "Id":824714799282655232,
                "Ctime":1500522991107,
                "Width":300,
                "Title":"u=125227023,978057929&fm=26&gp=0.jpg",
                "FileId":"To6bm_zeRbKSb0F
Wn2GwAAAApwZDIE",
                "Remark": "Remark"
            }
        }
    ],
    "Action":"ListTags",
    "Message":"success",
    "RequestId":"20BE5A2B-DB6B-410E-8F3B-D137165EAC98",
    "Code":"Success"
}


XML格式 <?xml version="1.0" encoding="UTF-8"?>
<ListTagsResponse>
  <Tags>
    <Tag>
      <Name>舞蹈</Name>
      <IsSubTag>false</IsSubTag>
      <ParentTag></ParentTag>
      <Cover>
        <Mtime>1500522991107</Mtime>
        <Md5>ac9cc6c68ae7f76d835e110a797baa14</Md5>
        <State>active</State>
        <Height>201</Height>
        <Ctime>1500522991107</Ctime>
        <Id>824714799282655232</Id>
        <Width>300</Width>
        <FileId>To6bm_zeRbKSb0FWn2GwAAAApwZDIE</FileId>
        <Title><![CDATA[u=125227023,978057929&fm=26&gp=0.jpg]]></Title>
        <Remark><![CDATA[Remark]]></Remark>
      </Cover>
      <Id>36864</Id>
    </Tag>
  </Tags>
  <Action>ListTags</Action>
  <Message>success</Message>
  <RequestId>584E5FCE-9A5B-4E8E-9C8F-27AD0ACDC007</RequestId>
  <Code>Success</Code>
</ListTagsResponse>

展开
收起
云栖大讲堂 2017-10-27 11:16:35 1839 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
CUDA MATH API 立即下载
API PLAYBOOK 立即下载
传统企业的“+互联网”-API服务在京东方的实践 立即下载