开始图片处理（api接口）-九游平台

使用流程

obs提供了rest接口。rest从资源的角度来观察整个网络，分布在各处的资源由uri（uniform resource identifier）确定，而客户端的应用通过url（unified resource locator）来获取资源。url的一般格式为：https://endpoint/uri。用户只需在浏览器地址栏中输入符合图片处理命令规则的url，即可获取到处理后的图片。

本章简要展示使用restful api接口方式访问和使用图片处理的流程，具体如图1所示。

图1 接口场景使用流程

注册账号并开通服务

在使用图片处理前，您需要拥有一个云服务账号并且成功开通obs。开通obs服务成功后图片处理也随之成功开通，使用obs服务之前必须先充值，充值完成后即可进行访问和使用。如果您已经开通obs且完成充值，请跳过此章节。

1. 打开华为云网站。
2. 单击“注册”。
3. 在注册页面，根据提示信息完成注册。

   注册成功后，系统会自动跳转至您的个人信息界面。

4. 为保证您正常使用图片处理，建议您先创建obs桶。

上传图片

您可以使用obs管理控制台、obs客户端和restful api方式上传图片。

具体请参见上传图片。

如果您的桶中已经存在需要处理的图片，请跳过此章节。

如果您需要通过自定义域名使用图片处理，需要为待处理的图片配置匿名用户读取权限。配置请参考对匿名用户授予指定对象的公共读权限进行配置。

处理图片

此章节介绍通过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为处理命令。处理命令之间和命令参数之间会使用三种分隔符，参见分隔符。如果不输入处理命令，将返回原图。

例如：

• 分隔符

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

• 管道

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

例如：为两个管道，执行顺序为从左到右，左侧命令处理结果将会作为右侧命令的输入。

样式访问方式

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.cn-north-4.myhuaweicloud.com/example.jpg?x-image-process=style/stylename