开发者社区> 问答> 正文

云相册的API开发接口GetPhotos怎么使用



描述


批量获取特定Id的照片信息

请求参数

参数名类型是否必须说明
ActionStringGetPhotos
PhotoId.1Long照片的唯一标识,如果有多张照片,请按照规则增加一个参数,比如2张照片,另外一个参数为PhotoId.2
StoreNameStringPhotoStore的名称
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


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





返回参数

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


Photos

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


返回示例


JSON格式 {
    "Photos":[
        {
            "IsVideo":false,
            "Md5":"6b680a5ec98537d18c87e9bb40fc0683",
            "Mtime":1499946529440,
            "State":"active",
            "Height":1200,
            "Id":822296943836270592,
            "Ctime":1499946529440,
            "Width":800,
            "Title":"demo-1.jpg",
            "FileId":"MkM1N9sjSLe_LWWyxcA80wAAAApwZDIE",
            "Remark":"",
            "TakenAt":1499946529440
        }
    ],
    "Action":"GetPhotos",
    "Message":"success",
    "RequestId":"FB3B50B3-6B7C-4584-8EC1-400F6EE8AD3C",
    "Code":"Success"
}


XML格式 <?xml version="1.0" encoding="UTF-8"?>
<GetPhotosResponse>
  <Photos>
    <Photo>
      <IsVideo>false</IsVideo>
      <Mtime>1499946529440</Mtime>
      <Md5>6b680a5ec98537d18c87e9bb40fc0683</Md5>
      <State>active</State>
      <Height>1200</Height>
      <Ctime>1499946529440</Ctime>
      <Id>822296943836270592</Id>
      <Width>800</Width>
      <FileId>MkM1N9sjSLe_LWWyxcA80wAAAApwZDIE</FileId>
      <Title>demo-1.jpg</Title>
      <Remark><Remark/>
      <TakenAt>1499946529440</TakenAt>
    </Photo>
  </Photos>
  <Action>GetPhotos</Action>
  <Message>success</Message>
  <RequestId>5A8A5036-4C5E-4373-9B49-5ECCE1DAF13C</RequestId>
  <Code>Success</Code>
</GetPhotosResponse>

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

相关电子书

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