› 推特 ›阿里云技术文档›正文

GetPublicAccessUrls_照片接口_API手册_智能云相册

admin 阿里云技术文档 2020-02-11 228 0
阿里云服务器优惠

GetPublicAccessUrls

描述

批量获取照片的公共访问地址，要求照片处于分享状态（也就是ShareExpireTime大于当前时间）。

在服务可用的情况下，该接口总是返回Success，需要根据返回结果里面的Result来判断具体单张照片的处理结果。

支持的SDK版本：1.1.5+

请求参数

参数名 类型 是否必须 说明
Action String 是 GetPublicAccessUrls
DomainType String 是 获取地址的域名类型，可选值为OSS或CDN。如果选择CDN，需要开通并完成配置CDN加速域名，参见开通CDN加速
PhotoId.1 Long 是 照片的唯一标识，如果有多张照片，请按照规则增加一个参数，比如2张照片，另外一个参数为PhotoId.2
StoreName String 是 PhotoStore的名称
ZoomType String 是 缩放格式。支持OSS的新版缩放格式，OSS的自定义图片样式（以style开头）和original。original表示获取照片原始文件下载地址。
LibraryId String 否 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetPublicAccessUrls
  2. &DomainType=OSS
  3. &PhotoId.1=859482148925661184
  4. &StoreName=cloudphoto-regression-store
  5. &ZoomType=style/medium
  6. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码，Success表示成功的响应
Message String 响应状态详细描述
Action String GetPublicAccessUrls
Results 数组 详见结果信息

Results

参数名 类型 说明
AccessUrl String 照片的访问地址
Code String 状态码，Success表示成功
PhotoId Long 照片的唯一ID
Message String 详细信息

返回示例

JSON格式

  1. {
  2.     "Action":"GetPublicAccessUrls",
  3.     "Message":"success",
  4.     "RequestId":"7DFBA1C4-6034-49AE-8269-0FB26A9A31FB",
  5.     "Results":[
  6.         {
  7.             "Message":"success",
  8.             "AccessUrl":"https://demo.oss-cn-shanghai.aliyuncs.com/stores/cloudphoto-regression-store/data/YT6KGq4FQBahx9FxcddXzgAAAC5wZDIE?x-oss-process=style/medium",
  9.             "PhotoId":859482148925661174,
  10.             "Code":"Success"
  11.         }
  12.     ],
  13.     "Code":"Success"
  14. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <GetPublicAccessUrlsResponse>
  3.   <Action>GetPublicAccessUrls</Action>
  4.   <Message>success</Message>
  5.   <RequestId>11053CBB-18C1-476C-A41D-23D6E067D1C1</RequestId>
  6.   <Results>
  7.     <Result>
  8.       <Message>success</Message>
  9.       <AccessUrl>https://demo.oss-cn-shanghai.aliyuncs.com/stores/cloudphoto-regression-store/data/YT6KGq4FQBahx9xcdXzgAAAC5wZDIE?x-oss-process=style/medium</AccessUrl>
  10.       <PhotoId>859482148925661184</PhotoId>
  11.       <Code>Success</Code>
  12.     </Result>
  13.   </Results>
  14.   <Code>Success</Code>
  15. </GetPublicAccessUrlsResponse>
版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----