开发者社区> 问答> 正文

云相册的API时光接口ListMomentPhotos怎么使用



描述


分批列出时光相簿中的照片

请求参数

参数名类型是否必须说明
ActionStringListMomentPhotos
StateString注意:State不是照片的状态,而是照片与时光相簿关系的状态。可选值为active(表示照片属于该时光相簿),removed(表示照片已从时光相簿中移除)和all(表示所有状态)
StoreNameStringPhotoStore的名称
MomentIdLong时光相簿的唯一标识
CursorString指定拉取数据的游标。默认值为0,表示从最老的数据开始分批获取。
DirectionString指定拉取数据的方向,可选值为backward和forward。forward表示获取比指定游标更新的数据,backward表示获取比指定游标更老的数据。默认值为forward
SizeInteger指定服务端返回的最大记录条数,最大值为500。默认值为50。
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


请求示例https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListMomentPhotos
&Cursor=0
&Direction=forward
&MomentId=824116383561293824
&Size=1
&State=active
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>





返回参数

参数名类型说明
RequestIdString唯一标识本次请求的ID
CodeString响应状态码,Success表示成功的响应
MessageString响应状态详细描述
ActionStringListMomentPhotos
NextCursorString表示获取下一批数据的起始游标,如果为EOF则表示没有数据了。
Results数组详见结果信息
TotalCountString符合条件的记录总数


Results

参数名类型说明
PhotoIdLong照片的唯一ID
StateString照片与时光相簿的关系的状态


返回示例


JSON格式 {
    "TotalCount":1,
    "Action":"ListMomentPhotos",
    "Message":"success",
    "RequestId":"296E0490-FBFD-4DDC-976D-64DE5A18A361",
    "NextCursor":"1500380317688:824116383590653952",
    "Results":[
        {
            "State":"active",
            "PhotoId":824116383510962176
        }
    ],
    "Code":"Success"
}


XML格式 <?xml version="1.0" encoding="UTF-8"?>
<ListMomentPhotosResponse>
  <Action>ListMomentPhotos</Action>
  <TotalCount>1</TotalCount>
  <Message>success</Message>
  <RequestId>BA202C9A-B302-44C0-8293-B70EA8C31EF7</RequestId>
  <NextCursor>1500380317688:824116383590653952</NextCursor>
  <Results>
    <Result>
      <State>active</State>
      <PhotoId>824116383510962176</PhotoId>
    </Result>
  </Results>
  <Code>Success</Code>
</ListMomentPhotosResponse>

展开
收起
云栖大讲堂 2017-10-27 10:47:11 1979 0
0 条回答
写回答
取消 提交回答
问答分类:
问答标签:
问答地址:
问答排行榜
最热
最新

相关电子书

更多
Spring Boot2.0实战Redis分布式缓存 立即下载
CUDA MATH API 立即下载
API PLAYBOOK 立即下载