云相册的API开发接口GetDownloadUrls怎么使用
描述
批量获取照片的原图下载地址，支持一次下载100张图片。下载地址的有效期为1小时。
注：SDK1.1.3版本后支持该接口。
请求参数
| 参数名 | 类型 | 是否必须 | 说明 |
| Action | String | 是 | GetDownloadUrls |
| PhotoId.1 | Long | 是 | 需要获取原图地址的照片的ID。如果有多张照片，请按照规则增加一个参数，比如2张照片，另外一个参数为PhotoId.2 |
| StoreName | String | 是 | PhotoStore的名称 |
| LibraryId | String | 否 | 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetDownloadUrls
&PhotoId.1=822879673959591936&PhotoId.2=822879673959591937
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>返回参数
| 参数名 | 类型 | 说明 |
| RequestId | String | 唯一标识本次请求的ID |
| Code | String | 响应状态码，Success表示成功的响应 |
| Message | String | 响应状态详细描述 |
| Action | String | GetDownloadUrls |
| Results | 数组 | 详见结果信息 |
Results
| 参数名 | 类型 | 说明 |
| Code | String | 状态码，Success表示成功 |
| Id | String | 对应对象的唯一标识 |
| Message | String | 详细信息 |
| DownloadUrl | String | 图片原图的下载地址 |
返回示例
JSON格式
{
"Action":"GetDownloadUrls",
"Code":"Success",
"Message":"success",
"RequestId":"52616503-B64F-4328-A99A-5C44FB37C06B",
"Results": [
{
"PhotoId": "822879673959591936",
"Code": "Success",
"Message": "success",
"DownloadUrl": "http://cloudphoto-demo.oss-cn-shanghai.aliyuncs.com/stores/cloudphoto-demo/data/ZUBaS964T3OYtqaal9MaZwAAAApwZDIE?Expires=1500090823&OSSAccessKeyId=STS.JSyQ7KKBQpztxczY8z7TdvDE8&Signature=so6XmgZrgz%2FrzOAJJHjH%2BjYVRdA%3D&security-token=CAISkAJ1q6Ft5B2yfSjIq5DMGo3%2Fpp1wx7ifekXLvTgvO9tImYHu2jz2IH9PdXRuCe4esv00mmlW7PYelr94T5hYSVTEatd3q5pW9Q66bpDfuse4tTaOBz0ZWjr9MQXy%2BeOPScebJYqvV5XAQlTAkTAJstmeXD6%2BXlujHISUgJp8FLo%2BVRW5ajw0b7U%2FZHEVyqkgOGDWKOymPzPzn2PUFzAIgAdnjn5l4qnNqa%2F1qDim1QekkL5F%2F9%2Brf8b9M5YwYa0SCYnlgLZEEYPayzNV5hRw86N7sbdJ4z%2BvvKvGXAIAvkvWbbKIq4YxdVEjNvQgaKdArenhk%2FZ8vfHfj4Tw1xFBMO9cTiDDXoekzdsTol0B%2F26DHxqAAbHkJHUVm9NGdF9oJ5cMp11ARy4avPX5wModwFQYX2kLrJpDIv%2BsvrSkGYd%2BGADtAOLnTsv%2Fs3Z7dtb88GcXbi7%2Fxfizd5kIIjZxbyGveAi%2BC994qQ2CrspPFM9s0wpT9%2BCN9jAmdKWRB3Y7WEaMp7I1VHEWbM3xVk9zhsePTcF%2F"
},
{
"PhotoId": "822879673959591937",
"Code": "ResourceNotFound.PhotoId",
"Message": "resource not found",
"DownloadUrl": ""
}
]
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<GetDownloadUrlResponse>
<Action>GetDownloadUrls</Action>
<Message>success</Message>
<RequestId>454544E2-3524-484D-A66F-AEA5C47A8BFF</RequestId>
<Results>
<Result>
<PhotoId>822879673959591936</PhotoId>
<Code>Success</Code>
<Message>success</Message>
<DownloadUrl><![CDATA[http://cloudphoto-demo.oss-cn-shanghai.aliyuncs.com/stores/cloudphoto-demo/data/ZUBaS964T3OYtqaal9MaZwAAAApwZDIE?Expires=1500090825&OSSAccessKeyId=STS.Df3DMrYveWAS9KiZUQYwmiRtY&Signature=R1ly%2FIHlE3EUlcErNZ0O6i%2BhhDk%3D&security-token=CAISkAJ1q6Ft5B2yfSjIpaWGD%2FfGtKlE4IO4O23YvlUEVfhBhpffuzz2IH9PdXRuCe4esv00mmlW7PYelr94T5hYSVTEatd3q5pW9Q66bpDfuse4tROeBz0ZWjr9MQXy%2BeOPScebJYqvV5XAQlTAkTAJstmeXD6%2BXlujHISUgJp8FLo%2BVRW5ajw0b7U%2FZHEVyqkgOGDWKOymPzPzn2PUFzAIgAdnjn5l4qnNqa%2F1qDim1QekkL5F%2F9%2Brf8b9M5YwYa0SCYnlgLZEEYPayzNV5hRw86N7sbdJ4z%2BvvKvGXAIAvkvWbbKIq4YxdVEjNvQgaKdArenhk%2FZ8vfHfj4Tw1xFBMO9cTiDDXoekzdsTol0B%2F26DHxqAAYQA%2FtawbSuvfuM8aH4eU0xs6OEI5TdTWUzTLzo4HzfPvShnVoA886XH7BKs3LN%2B2DTyCIn%2B2DoF5zVLZX1lxuxVFJhBsin1oMAcJ13KLTqPLl%2F9PDSyFKzTxfOdy8dQ1Q5tikBf9DyNArtaSxqgw4tydIN6di%2Fn6ojdRnyDv%2F]]>
</DownloadUrl>
</Result>
<Result>
<PhotoId>822879673959591937</PhotoId>
<Code>ResourceNotFound.PhotoId</Code>
<Message>resource not found</Message>
<DownloadUrl></DownloadUrl>
</Result>
</Results>
<Code>Success</Code>
</GetDownloadUrlResponse>
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
阿里云 AI 助理回答
您提到的功能是阿里云的“云相册”（Cloud Photo）服务中的一项接口能力，用于批量获取照片原图的下载地址。下面是对您描述内容的详细解析和补充说明：
接口名称
- GetDownloadUrls：此接口用于获取指定照片的原图下载链接。
请求参数详解
-
Action - 必选参数
- 类型：String
- 描述：操作名，此处应填写
GetDownloadUrls，表示请求获取下载链接的操作。
-
PhotoId.N - 必选参数，N 代表序号（如 PhotoId.1, PhotoId.2）
- 类型：Long
- 描述：需要获取原图地址的照片ID。如果有多张照片需要获取链接，请依次增加序号，例如第一张为
PhotoId.1，第二张为PhotoId.2，依此类推，最多支持一次请求中获取100张图片的下载地址。
-
StoreName - 必选参数
- 类型：String
- 描述：指定的PhotoStore名称，即存储空间的名称。
-
LibraryId - 可选参数
- 类型：String
- 描述：照片库标识。当使用AccessKey（AK）认证时，此参数是必须的；若采用STS（Security Token Service）临时授权认证，则可选。这涉及到不同的认证方式和权限管理策略。
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetDownloadUrls&PhotoId.1=123456789&PhotoId.2=987654321&StoreName=my_photo_store&LibraryId=L123456
在这个示例中，请求尝试获取两个照片的原图下载地址，照片ID分别为123456789和987654321，存储空间名为my_photo_store，并且指定了一个照片库标识L123456。
注意事项
- 确保您的SDK版本至少为1.1.3或以上，以支持该接口调用。
- 下载链接的有效期为1小时，请在有效期内完成下载。
- 调用此接口前，确保已正确配置了认证信息（AK/SK或STS Token），并具备访问指定照片库的权限。
- 根据实际需求调整请求中的参数，特别是
PhotoId.N部分，根据需要添加更多照片ID。
如果您在使用过程中遇到任何问题，建议查阅阿里云官方文档或联系技术支持获取帮助。
有帮助
无帮助
AI 助理回答生成答案可能存在不准确，仅供参考
相关问答