云相册的API相簿接口ListAlbumPhotos怎么使用
描述
分批获取相簿中的照片列表
请求参数
| 参数名 | 类型 | 是否必须 | 说明 |
| Action | String | 是 | ListAlbumPhotos |
| AlbumId | Long | 是 | 指定相簿的Id |
| State | String | 是 | 注意：State不是照片的状态，而是照片与相簿关系的状态。可选值为active（表示照片属于相簿中），removed（表示照片已从相簿中移除）和all（表示所有状态） |
| StoreName | String | 是 | PhotoStore的名称 |
| Cursor | String | 否 | 指定拉取数据的游标。默认值为0，表示从最老的数据开始分批获取。 |
| Direction | String | 否 | 指定拉取数据的方向，可选值为backward和forward。forward表示获取比指定游标更新的数据，backward表示获取比指定游标更老的数据。默认值为forward |
| Size | Integer | 否 | 指定服务端返回的最大记录条数，最大值为500。默认值为50。 |
| LibraryId | String | 否 | 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListAlbumPhotos
&AlbumId=822504789718867968
&Cursor=0
&Direction=forward
&Size=10
&State=all
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>返回参数
| 参数名 | 类型 | 说明 |
| RequestId | String | 唯一标识本次请求的ID |
| Code | String | 响应状态码，Success表示成功的响应 |
| Message | String | 响应状态详细描述 |
| Action | String | ListAlbumPhotos |
| NextCursor | String | 表示获取下一批数据的起始游标，如果为EOF则表示没有数据了。 |
| Results | 数组 | 详见结果信息 |
| TotalCount | String | 符合条件的记录总数 |
Results
| 参数名 | 类型 | 说明 |
| PhotoId | Long | 照片的唯一ID |
| State | String | 照片与相簿的关系的状态 |
返回示例
JSON格式
{
"TotalCount":1,
"Action":"ListAlbumPhotos",
"Message":"success",
"RequestId":"33439FC2-4729-4D74-A629-95CCF67ADA4E",
"NextCursor":"1501586905955:829177180117278720",
"Results":[
{
"State":"active",
"PhotoId":822522391505674240
}
],
"Code":"Success"
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<ListAlbumPhotosResponse>
<Action>ListAlbumPhotos</Action>
<TotalCount>1</TotalCount>
<Message>success</Message>
<RequestId>010AA821-CE89-44BA-9861-3BDED9CF1095</RequestId>
<NextCursor>1501586905955:829177180117278720</NextCursor>
<Results>
<Result>
<State>active</State>
<PhotoId>822522391505674240</PhotoId>
</Result>
</Results>
<Code>Success</Code>
</ListAlbumPhotosResponse>
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
您描述的是使用阿里云的Cloud Photo服务来分批获取相簿中的照片列表的操作。这个API调用允许用户高效地管理和检索存储在阿里云Cloud Photo平台上的照片，特别是当相簿中包含大量照片时，通过分批加载可以提升用户体验和系统性能。
请求参数说明：
-
Action: 必填参数，指定要执行的操作，这里是
ListAlbumPhotos，表示列出相簿中的照片。 -
AlbumId: 必填，Long类型，用来指定你想要获取照片的相簿ID。
-
State: 必填，String类型，用于筛选照片与相簿关系的状态。可选值有
active（照片属于相簿）、removed（照片已从相簿移除）和all（所有状态的照片）。 -
StoreName: 必填，String类型，表示使用的Photo Store名称，即存储空间的名称。
-
Cursor: 可选，String类型，作为分页查询的游标，用于指定从哪个位置开始获取数据，默认为0，即从最老的数据开始。
-
Direction: 可选，String类型，指定了数据拉取的方向，
forward表示获取比游标更新的数据（更新的照片），backward表示获取比游标更老的数据（更早的照片）。默认为forward。 -
Size: 可选，Integer类型，限制每次请求返回的最大记录数，最大支持500条，默认为50。
-
LibraryId: 可选，String类型，照片库标识。使用Access Key（AK）认证时是必须的，而采用Security Token Service (STS)认证时则可选。这涉及到不同的认证方式和权限管理。
请求示例展示了如何构造一个HTTP GET请求来调用此接口。请注意，实际使用时需要将https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListAlbumPhotos后面加上URL编码后的请求参数，形成完整的请求URL。
例如，如果要获取ID为123的相簿中最新的50张活跃状态的照片，且以正向顺序（从新到旧）获取，请求可能如下所示（注意实际请求还需包括其他必要的认证信息如AccessKeyId、Signature等）：
https://cloudphoto.cn-shanghai.aliyuncs.com/
?Action=ListAlbumPhotos
&AlbumId=123
&State=active
&StoreName=my_photo_store
&Size=50
&Direction=forward
&Format=json
&Version=2017-07-11
&Signature=[计算出的签名]
&AccessKeyId=[您的AccessKeyId]
&Timestamp=[当前时间戳]
请根据阿里云官方文档和SDK的具体要求，正确构造请求并进行签名处理，确保请求的安全性和有效性。
