云相册的API开发接口GetThumbnail怎么使用
描述
获取照片的缩略图地址，地址的有效期为1小时。
请求参数
| 参数名 | 类型 | 是否必须 | 说明 |
| Action | String | 是 | GetThumbnail |
| PhotoId | Long | 是 | 照片的唯一标识 |
| StoreName | String | 是 | PhotoStore的名称 |
| ZoomType | String | 是 | OSS的新版缩略图格式，比如image/resize,h_100将图片缩略成高度为100，宽度按比例处理。更多缩放格式请参考OSS的新版缩放格式 |
| LibraryId | String | 否 | 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetThumbnail
&PhotoId=822879673959591936
&StoreName=cloudphoto-demo
&ZoomType=image/resize,h_100
&LibraryId=alice-001
&<公共请求参数>返回参数
| 参数名 | 类型 | 说明 |
| RequestId | String | 唯一标识本次请求的ID |
| Code | String | 响应状态码，Success表示成功的响应 |
| Message | String | 响应状态详细描述 |
| Action | String | GetThumbnail |
| ThumbnailUrl | String | 图片缩略图的下载地址 |
返回示例
JSON格式
{
"Action":"GetThumbnail",
"Message":"success",
"RequestId":"95F81B72-12C7-4AC4-89B7-2FB9F2696DD7",
"Code":"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"
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<GetThumbnailResponse>
<Action>GetThumbnail</Action>
<Message>success</Message>
<RequestId>9D552BFC-2582-4899-84A2-E74C1BF4AF75</RequestId>
<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>
<Code>Success</Code>
</GetThumbnailResponse>
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
您提到的场景是关于使用阿里云的Cloud Photo服务来获取照片缩略图的地址。Cloud Photo服务是阿里云提供的一种面向企业和开发者，用于存储、管理和分发照片的解决方案。根据您的描述，这里是如何构造请求以获取照片缩略图地址的方法：
请求构造说明
-
Endpoint: 首先，您需要确定正确的服务端点（Endpoint），在您的示例中是
https://cloudphoto.cn-shanghai.aliyuncs.com。这个URL基于服务所在的区域，例如“cn-shanghai”代表中国上海区域。确保这个端点与您实际使用的阿里云服务区域相匹配。 -
Action: 必须参数，指定要执行的操作。在这个场景中，您需要获取缩略图，所以Action值为
GetThumbnail。 -
PhotoId: 照片的唯一标识符，必须提供。这用于定位您想要获取缩略图的具体照片。
-
StoreName: 照片存储空间的名称，也是必填项。这是您在Cloud Photo服务中创建的用来存放照片的空间。
-
ZoomType: 指定缩略图的生成规则，这是一个OSS（Object Storage Service）的新版缩略图格式字符串，例如
image/resize,h_100表示将图片高度调整为100像素，宽度按比例自动调整。您可以根据需求调整此参数以获得不同尺寸或比例的缩略图。 -
LibraryId（可选）: 如果您使用的是Access Key（AK）认证方式，则需要提供照片库标识。如果采用STS（Security Token Service）认证，则此参数可选。STS是一种临时安全凭证机制，适用于短期授权访问。
请求示例
基于上述信息，一个完整的请求URL示例可能如下所示（注意替换<...>内的实际值）：
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetThumbnail&PhotoId=<您的照片ID>&StoreName=<您的照片存储空间名称>&ZoomType=image/resize,h_100&LibraryId=<您的照片库ID>
请确保在实际调用时，您已经具备了相应的权限和认证信息，比如设置好AccessKey ID和AccessKey Secret（如果是AK认证），或者获取了有效的STS Token。此外，考虑到安全性，建议通过HTTPS进行请求，并且不要在公开场合直接暴露这些敏感信息。
