云相册的API开发接口GetThumbnails怎么使用
描述
批量获取照片的缩略图下载地址，支持一次获取100张图片的缩略图。地址的有效期为1小时。
注：SDK1.1.3版本后支持该接口。
请求参数
| 参数名 | 类型 | 是否必须 | 说明 |
| Action | String | 是 | GetThumbnails |
| PhotoId.1 | Long | 是 | 需要获取缩略图地址的照片的ID。如果有多张照片，请按照规则增加一个参数，比如2张照片，另外一个参数为PhotoId.2 |
| StoreName | String | 是 | PhotoStore的名称 |
| ZoomType | String | 是 | OSS的新版缩略图格式，比如image/resize,h_100将图片缩略成高度为100，宽度按比例处理。更多缩放格式请参考OSS的新版缩放格式 |
| LibraryId | String | 否 | 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetThumbnails
&PhotoId.1=822879673959591936&PhotoId.2=822879673959591937
&StoreName=cloudphoto-demo
&ZoomType=image/resize,h_100
&LibraryId=alice-001
&<公共请求参数>返回参数
| 参数名 | 类型 | 说明 |
| RequestId | String | 唯一标识本次请求的ID |
| Code | String | 响应状态码，Success表示成功的响应 |
| Message | String | 响应状态详细描述 |
| Action | String | GetThumbnails |
| Results | 数组 | 详见结果信息 |
Results
| 参数名 | 类型 | 说明 |
| Code | String | 状态码，Success表示成功 |
| Id | String | 对应对象的唯一标识 |
| Message | String | 详细信息 |
| ThumbnailUrl | String | 图片缩略图的下载地址 |
返回示例
JSON格式
{
"Action":"GetThumbnails",
"Message":"success",
"RequestId":"95F81B72-12C7-4AC4-89B7-2FB9F2696DD7",
"Code":"Success",
"Results": [
{
"PhotoId": "822879673959591936",
"Code": "Success",
"Message": "success",
"ThumbnailUrl": "http://cloudphoto-demo.img-cn-shanghai.aliyuncs.com/stores/cloudphoto-demo/data/ZUBaS964T3OYtqaal9MaZwAAAApwZDIE%40300w_300h_2o?Expires=1500091060&OSSAccessKeyId=STS.FoGkyomEnL5oiHy1aJ3jpusyU&Signature=VNlRDk4McBHevu5QeZ7US2sKHD0%3D&security-token=CAISkAJ1q6Ft5B2yfSjIp6zyIMPbgJpP%2B%2FeEa27I1WEfP%2BVcmrbStzz2IH9PdXRuCe4esv00mmlW7PYelr94T5hYSVTEatd3q5pW9Q66bpDfuse4tTjOFj0ZWjr9MQXy%2BeOPScebJYqvV5XAQlTAkTAJstmeXD6%2BXlujHISUgJp8FLo%2BVRW5ajw0b7U%2FZHEVyqkgOGDWKOymPzPzn2PUFzAIgAdnjn5l4qnNqa%2F1qDim1QekkL5F%2F9%2Brf8b9M5YwYa0SCYnlgLZEEYPayzNV5hRw86N7sbdJ4z%2BvvKvGXAIAvkvWbbKIq4YxdVEjNvQgaKdArenhk%2FZ8vfHfj4Tw1xFBMO9cTiDDXoekzdsTol0B%2F26DHxqAARn%2Fi1CNr7skp0WWXB9gdt1zE4fgxQGK7sRoSBQFs5vRffWu6WKUGdipTB24%2F3x%2B05FjIUJqBajZBUY6r0HvcChWlzoS%2FelZG0ANkCrnkjRAK7aKc6eW44dOmV8WaLiuW%2F%2FOTSo%2BCyAdfyeq%2B5jRV8hipnBpuy8%2FR5B9fAYl%2FPwr"
},
{
"PhotoId": "822879673959591937",
"Code": "ResourceNotFound.PhotoId",
"Message": "resource not found",
"ThumbnailUrl": ""
}
]
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<GetThumbnailResponse>
<Action>GetThumbnail</Action>
<Message>success</Message>
<RequestId>9D552BFC-2582-4899-84A2-E74C1BF4AF75</RequestId>
<Results>
<Result>
<PhotoId>822879673959591936</PhotoId>
<Code>Success</Code>
<Message>success</Message>
<ThumbnailUrl><![CDATA[http://cloudphoto-demo.img-cn-shanghai.aliyuncs.com/stores/cloudphoto-demo/data/ZUBaS964T3OYtqaal9MaZwAAAApwZDIE%40300w_300h_2o?Expires=1500091061&OSSAccessKeyId=STS.GiB8eHBKg6vW2weopJQQHwjNj&Signature=o7eUTDT3jMEBohv9c8EMvSQrThw%3D&security-token=CAISkAJ1q6Ft5B2yfSjIpqr3c9%2F8r5RGgbS8MFHUi3AfXd5kmK%2FliDz2IH9PdXRuCe4esv00mmlW7PYelr94T5hYSVTEatd3q5pW9Q66bpDfuse4tXHKFj0ZWjr9MQXy%2BeOPScebJYqvV5XAQlTAkTAJstmeXD6%2BXlujHISUgJp8FLo%2BVRW5ajw0b7U%2FZHEVyqkgOGDWKOymPzPzn2PUFzAIgAdnjn5l4qnNqa%2F1qDim1QekkL5F%2F9%2Brf8b9M5YwYa0SCYnlgLZEEYPayzNV5hRw86N7sbdJ4z%2BvvKvGXAIAvkvWbbKIq4YxdVEjNvQgaKdArenhk%2FZ8vfHfj4Tw1xFBMO9cTiDDXoekzdsTol0B%2F26DHxqAASMZ%2BwKcaBwU0gS%2B%2FYPaecXKYsoSFTyMhTM0v43YXXOZf18vRokrybrxe5HsDhamGv4KVKfvQ%2FEDeGCSX%2BP%2BSUiWMrOThZgPxZtfNcBMsOffg8FEfEZ9sJtZN%2FE5ssN3HUjVLqRMCcauKiGNpmfiMGQQ1hn3xq%2FhNUfrz0o15RHX]]>
</ThumbnailUrl>
</Result>
<Result>
<PhotoId>822879673959591937</PhotoId>
<Code>ResourceNotFound.PhotoId</Code>
<Message>resource not found</Message>
<ThumbnailUrl></ThumbnailUrl>
</Result>
</Results>
<Code>Success</Code>
</GetThumbnailResponse>
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
根据您的描述，您正在询问如何使用阿里云的Cloud Photo服务来批量获取照片缩略图的下载地址。Cloud Photo是阿里云提供的一项图片存储与管理服务，它允许用户上传、管理和分发图片资源。下面是如何利用该服务接口GetThumbnails来实现您的需求的简要说明：
请求目的
- 功能：批量获取指定照片ID列表中照片的缩略图URL。
- 数量限制：单次请求支持获取最多100张照片的缩略图链接。
- 有效期：生成的缩略图URL有效期为1小时。
请求参数详解
-
Action（操作类型）: 必填参数，固定值为
GetThumbnails，表示请求获取缩略图的操作。 -
PhotoId.N（照片ID）: 必填参数，其中N是一个数字序号，从1开始递增，如
PhotoId.1,PhotoId.2等，用于指定需要获取缩略图的照片ID。如果有多个照片ID，需要按照这个格式依次增加参数。 -
StoreName（存储名称）: 必填参数，指定了PhotoStore的名称，即在Cloud Photo中创建的存储空间名称。
-
ZoomType（缩略图格式）: 必填参数，定义了OSS（对象存储服务）生成缩略图的方式，例如
image/resize,h_100表示将图片高度调整为100像素，宽度按比例自动调整。更多格式请参考OSS文档中的新版缩放格式指南。 -
LibraryId（照片库标识）: 可选参数，当采用AccessKey认证时为必填项，用于指定照片所在的库。如果使用STS（Security Token Service）临时凭证认证，则此参数可选。了解不同认证方式对于正确配置请求很重要。
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/
?Action=GetThumbnails
&PhotoId.1=123456789
&PhotoId.2=987654321
&StoreName=YourStoreName
&ZoomType=image/resize,h_100
&LibraryId=OptionalLibraryId
&Signature=[YourSignature]
&[OtherRequiredParametersLikeTimestampAndAccessKeyId]
请注意，实际请求中还需要包含签名（Signature）、时间戳（Timestamp）、AccessKeyId等安全相关的参数，这些通常由SDK自动生成或通过计算得出，确保请求的安全性。具体生成签名的方法和其它必要参数的添加，请参照阿里云Cloud Photo服务的官方文档和相应的SDK使用指南进行操作。
确保使用的SDK版本不低于1.1.3，因为该接口是在这个版本之后才被支持的。如果您在使用过程中遇到任何问题，建议查阅最新的API文档或联系阿里云技术支持获取帮助。
