更新时间:2024-03-04 GMT+08:00

处理图片

此章节介绍通过RESTestful API方式进行图片处理操作的URL构成。当已成功开通OBS后,在浏览器地址中输入符合规则的URL即可通过RESTful API方式使用图片处理。

URL组成形式

URL由OBS域名、OBS上的桶名、原图片名称、处理命令或样式名组成。

命令访问方式

URL形式为:https://bucketName.endpoint/objectName?x-image-process=image/commands

  • endpoint为桶所在区域对应的终端节点地址,可以在桶的基本信息处获取。有关OBS区域和终端节点的更多信息,请参考地区和终端节点
  • bucketName为OBS中待处理图片存放的桶名。
  • objectName为存储在OBS上bucketName桶下的原图片名称,后缀名必须为图片处理支持的图片格式。
  • commands为处理命令。处理命令之间和命令参数之间会使用三种分隔符,参见分隔符。如果不输入处理命令,将返回原图。

例如:https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/crop,x_100,y_50

  • 分隔符

分隔符是指URL中用来区分命令访问方式一些关键字段的分隔符号。具体说明如表1所示。

表1 分隔符

名称

样式

顺序

说明

参数分隔符

_

固定顺序

命令参数与参数值之间的分隔符。

命令分隔符

,

无关

多项处理命令参数之间的分隔符。

管道分隔符

/

有关

两组处理命令之间分隔符,参见管道

  • 管道

如果一个图片,需要进行多重处理,如先剪切、后缩略等,则多组操作命令之间,需要以管道分隔符“/”进行连接,执行顺序按管道指定顺序从左至右执行。

例如:https://image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,w_100,h_100/quality,q_80为两个管道,执行顺序为从左到右,左侧命令处理结果将会作为右侧命令的输入。

样式访问方式

URL形式为:https://bucketName.endpoint/objectName?x-image-process=style/stylename

  • endpoint为桶所在区域对应的终端节点地址,可以在桶的基本信息处获取。有关OBS区域和终端节点的更多信息,请参考地区和终端节点
  • bucketName为OBS上的桶名。
  • objectName为存储在OBS上bucketName桶下的原图片名称,后缀名必须为图片处理支持的图片格式。
  • stylename为在控制台bucketName桶下创建好的样式名称。RESTful API方式现暂不支持其他样式相关等操作,如创建样式、更改样式和删除样式。

样例:https://image-demo.obs.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=style/stylename