全部产品
云市场

FetchPhotos

更新时间:2018-04-24 13:36:01

描述

分页获取用户照片

请求参数

参数名 类型 是否必须 说明
Action String FetchPhotos
Order String 指定排序方式,可选值为asc, desc,分别表示升序和降序。默认值为asc
OrderBy String 指定用于排序的属性,可选值为mtime表示最后修改时间,ctime表示照片创建时间,takenAt表示照片的拍摄时间,inactiveTime表示照片的逻辑删除时间。默认值为ctime
Page Integer 指定需要获取的页数,默认为1
Size Integer 指定每页返回照片的数量,最大为500,默认为50
State String 指定需要获取特定状态的照片,可选值为active表示正常状态,inactive表示逻辑删除,deleted表示物理删除,all表示所有。默认为active
StoreName String PhotoStore的名称
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

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

返回参数

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

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":"859482159273005056",
  5. "IsVideo":false,
  6. "Md5":"cbaa9d159391f659ad83f9c74d0fb107",
  7. "ShareExpireTime":0,
  8. "Location":"",
  9. "Height":300,
  10. "Title":"testimage2.jpg",
  11. "FileId":"M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE",
  12. "Mtime":1508812175585,
  13. "InactiveTime":0,
  14. "State":"active",
  15. "Id":859482159273005056,
  16. "Ctime":1508812175585,
  17. "Width":400,
  18. "Remark":"",
  19. "TakenAt":0,
  20. "Size":6687
  21. }
  22. ],
  23. "TotalCount":16,
  24. "Action":"FetchPhotos",
  25. "Message":"success",
  26. "RequestId":"4BA9EFDB-DD0F-44F7-B9F9-456F55C00018",
  27. "Code":"Success"
  28. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <FetchPhotosResponse>
  3. <Photos>
  4. <Photo>
  5. <IdStr>859482159273005056</IdStr>
  6. <IsVideo>false</IsVideo>
  7. <Md5>cbaa9d159391f659ad83f9c74d0fb107</Md5>
  8. <ShareExpireTime>0</ShareExpireTime>
  9. <Location/>
  10. <Height>300</Height>
  11. <Title>testimage2.jpg</Title>
  12. <FileId>M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE</FileId>
  13. <Mtime>1508812175585</Mtime>
  14. <InactiveTime>0</InactiveTime>
  15. <State>active</State>
  16. <Ctime>1508812175585</Ctime>
  17. <Id>859482159273005056</Id>
  18. <Width>400</Width>
  19. <TakenAt>0</TakenAt>
  20. <Remark/>
  21. <Size>6687</Size>
  22. </Photo>
  23. </Photos>
  24. <Action>FetchPhotos</Action>
  25. <TotalCount>16</TotalCount>
  26. <Message>success</Message>
  27. <RequestId>3CA60963-0985-4FDE-8852-584E40863D87</RequestId>
  28. <Code>Success</Code>
  29. </FetchPhotosResponse>