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

ListMoments_时光接口_API手册_智能云相册

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

ListMoments

描述

分批列出当前用户的时光相簿

请求参数

参数名 类型 是否必须 说明
Action String 是 ListMoments
State String 是 指定时光的状态，服务端只返回指定状态的时光。可选值有active, inactive, all。关于时光状态的变化请参考：数据模型
StoreName String 是 PhotoStore的名称
Cursor String 否 指定拉取数据的游标。默认值为0，表示从最老的数据开始分批获取。
Direction String 否 指定拉取数据的方向，可选值为backward和forward。forward表示获取比指定游标更新的数据，backward表示获取比指定游标更老的数据。默认值为forward
Size Integer 否 指定服务端返回的最大记录条数，最大值为500。默认值为50。
LibraryId String 否 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListMoments
  2. &Cursor=0
  3. &Direction=forward
  4. &Size=1
  5. &State=active
  6. &StoreName=cloudphoto-demo
  7. &LibraryId=alice-001
  8. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码，Success表示成功的响应
Message String 响应状态详细描述
Action String ListMoments
Moments Moment[] Moment数组
NextCursor String 表示获取下一批数据的起始游标，如果为EOF则表示没有数据了。
TotalCount String 符合条件的记录总数

Moments

参数名 类型 说明
Ctime String 创建的时间戳，单位：毫秒
Id Long 时光相簿的Id
LocationName String 时光相簿的拍摄地点
Mtime String 最后修改的时间戳，单位：毫秒
PhotosCount Integer 时光相簿中的照片总数
State String 时光相簿的状态
TakenAt Long 时光相簿的拍摄时间戳

返回示例

JSON格式

  1. {
  2.     "TotalCount":29,
  3.     "Action":"ListMoments",
  4.     "Message":"success",
  5.     "RequestId":"E26C0E58-1204-4262-928C-AC5A76BFE979",
  6.     "Moments":[
  7.         {
  8.             "Mtime":1500380317681,
  9.             "LocationName":"",
  10.             "State":"active",
  11.             "Id":824116383561293824,
  12.             "Ctime":1500380317681,
  13.             "TakenAt":1500307201000,
  14.             "PhotosCount":1
  15.         }
  16.     ],
  17.     "NextCursor":"1500380317681:824116383561293824",
  18.     "Code":"Success"
  19. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <ListMomentsResponse>
  3.   <Action>ListMoments</Action>
  4.   <TotalCount>29</TotalCount>
  5.   <Message>success</Message>
  6.   <RequestId>7058AE4B-AEB9-4840-9E70-E9FF37E3B17D</RequestId>
  7.   <Moments>
  8.     <Moment>
  9.       <Mtime>1500380317681</Mtime>
  10.       <State>active</State>
  11.       <LocationName/>
  12.       <Ctime>1500380317681</Ctime>
  13.       <Id>824116383561293824</Id>
  14.       <TakenAt>1500307201000</TakenAt>
  15.       <PhotosCount>1</PhotosCount>
  16.     </Moment>
  17.   </Moments>
  18.   <NextCursor>1500380317681:824116383561293824</NextCursor>
  19.   <Code>Success</Code>
  20. </ListMomentsResponse>
版权声明

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

评论

-----