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认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetPublicAccessUrls
&DomainType=OSS
&PhotoId.1=859482148925661184
&StoreName=cloudphoto-regression-store
&ZoomType=style/medium
&<公共请求参数>
返回参数
参数名 | 类型 | 说明 |
---|---|---|
RequestId | String | 唯一标识本次请求的ID |
Code | String | 响应状态码,Success表示成功的响应 |
Message | String | 响应状态详细描述 |
Action | String | GetPublicAccessUrls |
Results | 数组 | 详见结果信息 |
Results
参数名 | 类型 | 说明 |
---|---|---|
AccessUrl | String | 照片的访问地址 |
Code | String | 状态码,Success表示成功 |
PhotoId | Long | 照片的唯一ID |
Message | String | 详细信息 |
返回示例
JSON格式
{
"Action":"GetPublicAccessUrls",
"Message":"success",
"RequestId":"7DFBA1C4-6034-49AE-8269-0FB26A9A31FB",
"Results":[
{
"Message":"success",
"AccessUrl":"https://demo.oss-cn-shanghai.aliyuncs.com/stores/cloudphoto-regression-store/data/YT6KGq4FQBahx9FxcddXzgAAAC5wZDIE?x-oss-process=style/medium",
"PhotoId":859482148925661174,
"Code":"Success"
}
],
"Code":"Success"
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<GetPublicAccessUrlsResponse>
<Action>GetPublicAccessUrls</Action>
<Message>success</Message>
<RequestId>11053CBB-18C1-476C-A41D-23D6E067D1C1</RequestId>
<Results>
<Result>
<Message>success</Message>
<AccessUrl>https://demo.oss-cn-shanghai.aliyuncs.com/stores/cloudphoto-regression-store/data/YT6KGq4FQBahx9xcdXzgAAAC5wZDIE?x-oss-process=style/medium</AccessUrl>
<PhotoId>859482148925661184</PhotoId>
<Code>Success</Code>
</Result>
</Results>
<Code>Success</Code>
</GetPublicAccessUrlsResponse>
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论