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

ListPhotos_照片接口_API手册_智能云相册

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

ListPhotos

描述

分批获取用户照片

请求参数

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

请求示例

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

返回参数

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

Photos

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

返回示例

JSON格式

  1. {
  2.     "Photos":[
  3.         {
  4.             "IsVideo":false,
  5.             "Md5":"cbaa9d159391f659ad83f9c74d0fb107",
  6.             "ShareExpireTime":0,
  7.             "Height":300,
  8.             "Title":"testimage2.jpg",
  9.             "FileId":"M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE",
  10.             "Mtime":1508812175585,
  11.             "InactiveTime":0,
  12.             "State":"active",
  13.             "Id":859482159273005056,
  14.             "Ctime":1508812175585,
  15.             "Width":400,
  16.             "TakenAt":0,
  17.             "Remark":""
  18.         }
  19.     ],
  20.     "TotalCount":13,
  21.     "Action":"ListPhotos",
  22.     "Message":"success",
  23.     "RequestId":"AA52B2BD-F003-4CA9-99EA-C400982DECAD",
  24.     "NextCursor":"1508812175585:859482159273005056",
  25.     "Code":"Success"
  26. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <ListPhotosResponse>
  3.   <Photos>
  4.     <Photo>
  5.       <IsVideo>false</IsVideo>
  6.       <Md5>cbaa9d159391f659ad83f9c74d0fb107</Md5>
  7.       <ShareExpireTime>0</ShareExpireTime>
  8.       <Height>300</Height>
  9.       <Title>testimage2.jpg</Title>
  10.       <FileId>M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE</FileId>
  11.       <Mtime>1508812175585</Mtime>
  12.       <InactiveTime>0</InactiveTime>
  13.       <State>active</State>
  14.       <Id>859482159273005056</Id>
  15.       <Ctime>1508812175585</Ctime>
  16.       <Width>400</Width>
  17.       <Remark/>
  18.       <TakenAt>0</TakenAt>
  19.     </Photo>
  20.   </Photos>
  21.   <Action>ListPhotos</Action>
  22.   <TotalCount>13</TotalCount>
  23.   <Message>success</Message>
  24.   <RequestId>DE8A9553-D421-4A5F-8EEE-6942A223C97A</RequestId>
  25.   <NextCursor>1508812175585:859482159273005056</NextCursor>
  26.   <Code>Success</Code>
  27. </ListPhotosResponse>
版权声明

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

评论

-----