开发者社区> 问答> 正文

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



描述


批量获取照片的原图下载地址,支持一次下载100张图片。下载地址的有效期为1小时。
注:SDK1.1.3版本后支持该接口。

请求参数

参数名类型是否必须说明
ActionStringGetDownloadUrls
PhotoId.1Long需要获取原图地址的照片的ID。如果有多张照片,请按照规则增加一个参数,比如2张照片,另外一个参数为PhotoId.2
StoreNameStringPhotoStore的名称
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


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





返回参数

参数名类型说明
RequestIdString唯一标识本次请求的ID
CodeString响应状态码,Success表示成功的响应
MessageString响应状态详细描述
ActionStringGetDownloadUrls
Results数组详见结果信息


Results

参数名类型说明
CodeString状态码,Success表示成功
IdString对应对象的唯一标识
MessageString详细信息
DownloadUrlString图片原图的下载地址


返回示例


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>

展开
收起
云栖大讲堂 2017-10-27 10:12:21 1929 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
CUDA MATH API 立即下载
API PLAYBOOK 立即下载
传统企业的“+互联网”-API服务在京东方的实践 立即下载