获取原图

最近更新时间:2024-07-03 15:37:12

我的收藏

功能概述

如果您开启了 原图保护功能,同时在某些场景下希望获取到原图,可通过本接口进行获取。
注意:
该请求操作不支持匿名请求,必须携带签名。

授权说明

通过子账号使用时,需要授予 cos:GetObject权限,具体请参见 COS action,CI 其他权限请参见 数据万象 action

服务开通

使用该功能将默认为您开通数据万象,并绑定存储桶,无需角色授权,即可直接使用。

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

费用说明

该接口为付费服务,产生的费用将由数据万象收取,详细计费说明可参见 图片处理费用
如果采用下载时处理的方式,且通过外网进行下载,调用会产生 流量费用

请求

请求示例

GET /<ObjectKey>?ci-process=originImage HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

请求参数说明

参数
描述
类型
是否必选
ci-process
万象通用参数,需要获取原图的时,该参数固定为:originImage
string

请求头

该接口无特殊请求头。

请求体

该接口无请求体。

响应

响应头

该接口无特殊响应头。

响应体

该接口的响应体为对象(文件)内容。

实际案例

访问一张已开启了原图保护的存储桶中的图片,并携带获取原图参数:
http://example-1250000000.cos.ap-chengdu.myqcloud.com/?ci-process=originImage&q-sign-algorithm=sha1&q-ak=xxx&q-sign-time=1682323014;1682326614&q-key-time=1682323014;1682326614&q-header-list=&q-url-param-list=ci-process&q-signature=xxxxx
说明:
<signature> 为签名部分,获取方式请参考 请求签名,计算的签名中需将处理参数ci-process也一并签入。