FetchMomentPhotos
描述
分页获取时光相簿中的照片
请求参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
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认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=FetchMomentPhotos
&MomentId=859482152956387328
&Order=asc
&OrderBy=uploadAt
&Page=1
&Size=1
&StoreName=cloudphoto-regression-store
&<公共请求参数>
返回参数
参数名 | 类型 | 说明 |
---|---|---|
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格式
{
"Photos":[
{
"IdStr":"859482148925661184",
"IsVideo":false,
"Md5":"dbb54eb343132e0ecd09267a556b6b1c",
"ShareExpireTime":9223372036854775807,
"Height":300,
"Title":"new title",
"FileId":"YT6KGq4FQBahx9FkcYdXzgAAAC5wZDIE",
"Mtime":1508816554740,
"InactiveTime":0,
"State":"active",
"Id":859482148925661184,
"Ctime":1508812173188,
"Width":200,
"Remark":"new remark",
"TakenAt":0,
"Size":7063
}
],
"TotalCount":1,
"Action":"FetchMomentPhotos",
"Message":"success",
"RequestId":"46415800-7F3B-4A4C-9D6D-B5B6C4834DE2",
"Code":"Success"
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<FetchMomentPhotosResponse>
<Photos>
<Photo>
<IdStr>859482148925661184</IdStr>
<IsVideo>false</IsVideo>
<Md5>dbb54eb343132e0ecd09267a556b6b1c</Md5>
<ShareExpireTime>9223372036854775807</ShareExpireTime>
<Height>300</Height>
<Title>new title</Title>
<FileId>YT6KGq4FQBahx9FkcYdXzgAAAC5wZDIE</FileId>
<Mtime>1508816554740</Mtime>
<InactiveTime>0</InactiveTime>
<State>active</State>
<Ctime>1508812173188</Ctime>
<Id>859482148925661184</Id>
<Width>200</Width>
<TakenAt>0</TakenAt>
<Remark>new remark</Remark>
<Size>7063</Size>
</Photo>
</Photos>
<Action>FetchMomentPhotos</Action>
<TotalCount>1</TotalCount>
<Message>success</Message>
<RequestId>A82EB93A-4CEB-4FF8-A3D1-840CFA25C41F</RequestId>
<Code>Success</Code>
</FetchMomentPhotosResponse>
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论