全部产品
云市场

FetchMomentPhotos

更新时间:2018-04-17 17:58:45

描述

分页获取时光相簿中的照片

请求参数

参数名 类型 是否必须 说明
Action String FetchMomentPhotos
MomentId Long 时光相簿的唯一标识
Order String 指定照片排序的方式,可选值为asc(升序)和desc(降序),默认值为desc
OrderBy String 指定用于照片排序的字段,可选值为takenAt(拍摄时间)和uploadAt(上传时间),默认值为takenAt
Page Integer 指定需要获取的页数,默认为1
Size Integer 指定每页返回的照片数,默认为100
StoreName String PhotoStore的名称
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=FetchMomentPhotos
  2. &MomentId=859482152956387328
  3. &Order=asc
  4. &OrderBy=uploadAt
  5. &Page=1
  6. &Size=1
  7. &StoreName=cloudphoto-regression-store
  8. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码,Success表示成功的响应
Message String 响应状态详细描述
Action String FetchMomentPhotos
Photos Photo[] Photo数组
TotalCount Long 符合条件的记录总数

Photos

参数名 类型 说明
Ctime Long 创建的时间戳,单位:毫秒
FileId String 照片对应到存储在OSS上的文件名
Height Integer 照片的高度
Id Long 记录的唯一标识
IdStr String 字符串形式的记录的唯一标识
InactiveTime Long 照片逻辑删除的时间戳,单位:毫秒
IsVideo Boolean 是否为视频,取值为true/false。
Md5 String 文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。
Mtime Long 最后修改的时间戳,单位:毫秒
Remark String 备注
ShareExpireTime Long 照片的分享过期时间,单位:毫秒
Size Long 照片的大小,单位:字节
State String 照片的状态
TakenAt Long 从照片的Exif读取到的照片拍摄时间,单位:毫秒
Title String 照片的名称
Width Integer 照片的宽度

返回示例

JSON格式

  1. {
  2. "Photos":[
  3. {
  4. "IdStr":"859482148925661184",
  5. "IsVideo":false,
  6. "Md5":"dbb54eb343132e0ecd09267a556b6b1c",
  7. "ShareExpireTime":9223372036854775807,
  8. "Height":300,
  9. "Title":"new title",
  10. "FileId":"YT6KGq4FQBahx9FkcYdXzgAAAC5wZDIE",
  11. "Mtime":1508816554740,
  12. "InactiveTime":0,
  13. "State":"active",
  14. "Id":859482148925661184,
  15. "Ctime":1508812173188,
  16. "Width":200,
  17. "Remark":"new remark",
  18. "TakenAt":0,
  19. "Size":7063
  20. }
  21. ],
  22. "TotalCount":1,
  23. "Action":"FetchMomentPhotos",
  24. "Message":"success",
  25. "RequestId":"46415800-7F3B-4A4C-9D6D-B5B6C4834DE2",
  26. "Code":"Success"
  27. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <FetchMomentPhotosResponse>
  3. <Photos>
  4. <Photo>
  5. <IdStr>859482148925661184</IdStr>
  6. <IsVideo>false</IsVideo>
  7. <Md5>dbb54eb343132e0ecd09267a556b6b1c</Md5>
  8. <ShareExpireTime>9223372036854775807</ShareExpireTime>
  9. <Height>300</Height>
  10. <Title>new title</Title>
  11. <FileId>YT6KGq4FQBahx9FkcYdXzgAAAC5wZDIE</FileId>
  12. <Mtime>1508816554740</Mtime>
  13. <InactiveTime>0</InactiveTime>
  14. <State>active</State>
  15. <Ctime>1508812173188</Ctime>
  16. <Id>859482148925661184</Id>
  17. <Width>200</Width>
  18. <TakenAt>0</TakenAt>
  19. <Remark>new remark</Remark>
  20. <Size>7063</Size>
  21. </Photo>
  22. </Photos>
  23. <Action>FetchMomentPhotos</Action>
  24. <TotalCount>1</TotalCount>
  25. <Message>success</Message>
  26. <RequestId>A82EB93A-4CEB-4FF8-A3D1-840CFA25C41F</RequestId>
  27. <Code>Success</Code>
  28. </FetchMomentPhotosResponse>