开发者社区 问答 正文

云相册的API开发接口GetDownloadUrl怎么使用



描述


获取照片的原图下载地址。下载地址的有效期为1小时。

请求参数

参数名类型是否必须说明
ActionStringGetDownloadUrl
PhotoIdLong照片的唯一标识
StoreNameStringPhotoStore的名称
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


请求示例https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetDownloadUrl
&PhotoId=822879673959591936
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>





返回参数

参数名类型说明
RequestIdString唯一标识本次请求的ID
CodeString响应状态码,Success表示成功的响应
MessageString响应状态详细描述
ActionStringGetDownloadUrl
DownloadUrlString照片的原图下载地址


返回示例


JSON格式 {
    "Action":"GetDownloadUrl",
    "Message":"success",
    "RequestId":"52616503-B64F-4328-A99A-5C44FB37C06B",
    "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",
    "Code":"Success"
}


XML格式 <?xml version="1.0" encoding="UTF-8"?>
<GetDownloadUrlResponse>
  <Action>GetDownloadUrl</Action>
  <Message>success</Message>
  <RequestId>454544E2-3524-484D-A66F-AEA5C47A8BFF</RequestId>
  <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>
  <Code>Success</Code>
</GetDownloadUrlResponse>

展开
收起
云栖大讲堂 2017-10-27 10:10:38 2103 分享 版权
阿里云 AI 助理回答

您提到的场景是关于阿里云Cloud Photo服务中获取照片原图下载地址的请求。Cloud Photo是阿里云提供的一种图片存储与管理服务,它帮助用户高效地存储、管理和分发照片资源。根据您的描述,要获取一张照片的原图下载地址,并且该链接有效期为1小时,您需要通过调用Cloud Photo API中的GetDownloadUrl操作来实现。

请求参数说明:

  • Action: 必须参数,固定值为GetDownloadUrl,表示请求的操作类型。
  • PhotoId: 必须参数,类型为Long,表示您想下载的照片在Cloud Photo服务中的唯一标识。
  • StoreName: 必须参数,类型为String,表示存储照片的Photo Store名称。每个Photo Store可以看作是一个独立的照片存储空间。
  • LibraryId: 可选参数,类型为String,表示照片库的标识。当使用AccessKey(AK)认证方式时,此参数是必须的;如果采用Security Token Service (STS)认证,则可选。STS是一种临时授权机制,允许您为第三方应用或临时用户分配有限的访问权限。

请求示例:

https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetDownloadUrl&PhotoId=1234567890&StoreName=my_photo_store&LibraryId=L12345678

在这个示例URL中: - Action=GetDownloadUrl 指定了操作类型为获取下载链接。 - PhotoId=1234567890 是一个假设的照片ID,实际使用时应替换为真实照片的ID。 - StoreName=my_photo_store 是存储照片的Photo Store名称,同样需要替换为实际的名称。 - LibraryId=L12345678 是一个可选参数,在使用AK认证时需要提供,这里也是示例值,需替换为实际的库标识。

请注意,实际发起请求时,除了直接构建URL外,还需要遵循阿里云API的签名规则,即对请求进行签名以验证请求的合法性。这通常涉及到AccessKeyId、AccessKeySecret以及安全令牌(如果使用STS)等信息,并且可能需要使用HTTP客户端库或者阿里云提供的SDK来构造完整的请求。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答