› 推特 ›阿里云技术文档›正文

GetAlbumsByNames_相簿接口_API手册_智能云相册

admin 阿里云技术文档 2020-02-11 222 0
阿里云服务器优惠

GetAlbumsByNames

描述

根据相簿名称获取相簿信息

请求参数

参数名 类型 是否必须 说明
Action String 是 GetAlbumsByNames
Name.1 String 是 需要获取的相簿名称。如果需要获取多个相簿的信息，请按照规则增加一个参数。比如2个相簿，另外一个参数为Name.2
StoreName String 是 PhotoStore的名称
LibraryId String 否 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetAlbumsByNames
  2. &Name.1=demo-album-002
  3. &StoreName=cloudphoto-regression-store
  4. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码，Success表示成功的响应
Message String 响应状态详细描述
Action String GetAlbumsByNames
Albums Album[] Album数组

Albums

参数名 类型 说明
Cover 对象 相册的封面
Ctime String 创建的时间戳，单位：毫秒
Id Long 相簿的Id
IdStr String 以字符串表示的相簿的Id
Mtime String 最后修改的时间戳，单位：毫秒
Name String 相簿的名称
PhotosCount Integer 相簿的中的照片数量
State String 相簿的状态

Cover

参数名 类型 说明
Ctime String 创建的时间戳，单位：毫秒
FileId String 照片对应到存储在OSS上的文件名
Height Integer 照片的高度
Id String 相簿封面照片的Id
IdStr String 以字符串表示的相簿封面照片的Id
IsVideo Boolean 是否为视频，取值为true/false。
Md5 String 文件的Md5值。如果文件是以OSS分块上传方式上传的话，文件MD5为异步计算，在计算完成以前，MD5值为空。
Mtime String 最后修改的时间戳，单位：毫秒
Remark String 备注
State String 照片的状态
Title String 照片的名称
Width Integer 照片的宽度

返回示例

JSON格式

  1. {
  2.     "Action":"GetAlbumsByNames",
  3.     "Message":"success",
  4.     "RequestId":"DBA28C13-00F6-4478-8B26-748695687E0B",
  5.     "Code":"Success",
  6.     "Albums":[
  7.         {
  8.             "Name":"demo-album-002",
  9.             "IdStr":"",
  10.             "Mtime":1520848479597,
  11.             "State":"active",
  12.             "Id":837495818708848640,
  13.             "Ctime":1503570223599,
  14.             "Cover":{
  15.                 "IdStr":"859482159273005056",
  16.                 "IsVideo":false,
  17.                 "Md5":"cbaa9d159391f659ad83f9c74d0fb107",
  18.                 "Mtime":1508812175585,
  19.                 "State":"active",
  20.                 "Height":300,
  21.                 "Id":859482159273005056,
  22.                 "Ctime":1508812175585,
  23.                 "Width":400,
  24.                 "Remark":"",
  25.                 "Title":"testimage2.jpg",
  26.                 "FileId":"M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE"
  27.             },
  28.             "PhotosCount":1
  29.         }
  30.     ]
  31. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <GetAlbumsByNamesResponse>
  3.   <Action>GetAlbumsByNames</Action>
  4.   <Message>success</Message>
  5.   <RequestId>A6CDE0C3-F568-4958-B955-3C9FD5EA1513</RequestId>
  6.   <Code>Success</Code>
  7.   <Albums>
  8.     <Album>
  9.       <IdStr/>
  10.       <Name>demo-album-002</Name>
  11.       <Mtime>1520848479597</Mtime>
  12.       <State>active</State>
  13.       <Cover>
  14.         <IsVideo>false</IsVideo>
  15.         <IdStr>859482159273005056</IdStr>
  16.         <Mtime>1508812175585</Mtime>
  17.         <Md5>cbaa9d159391f659ad83f9c74d0fb107</Md5>
  18.         <State>active</State>
  19.         <Height>300</Height>
  20.         <Ctime>1508812175585</Ctime>
  21.         <Id>859482159273005056</Id>
  22.         <Width>400</Width>
  23.         <Remark/>
  24.         <FileId>M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE</FileId>
  25.         <Title>testimage2.jpg</Title>
  26.       </Cover>
  27.       <Ctime>1503570223599</Ctime>
  28.       <Id>837495818708848640</Id>
  29.       <PhotosCount>1</PhotosCount>
  30.     </Album>
  31.   </Albums>
  32. </GetAlbumsByNamesResponse>
版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----