添加一个资源样式

接口描述：

  • 添加一个资源样式。

请求 URL：

  • http|https://host/api/v1/storage_style/method/add.storage.style.item/

请求方式：

  • GET
  • POST

是否授权：

  • 需要授权

业务参数：

参数名 类型 是否必须 范围值 默认值 示例值 描述
name string 是 max:64 PC商品主图 资源样式名称
code string 是 max:32 index_goods_image 资源样式编码
platform integer 是 between:-128,127 0 资源样式平台(自定义)
size array 否 max[]:2 [800,800] 资源缩略尺寸
crop array 否 max[]:2 [100,100] 资源裁剪尺寸
quality integer 否 between:0,100 0 100 资源图片质量 0=系统默认
type string 否 见附属 A jpg 资源输出格式，空则原样输出
style string 否 max:64 demo 第三方OSS样式
status integer 否 in:0,1 1 1 状态 0=禁用 1=启用

附属 A： in:jpg,png,svg,gif,bmp,tiff,webp

响应参数：

参数名 类型 是否返回 示例值 描述
status integer 是 200 状态码
message string 是 success 消息信息
data object 是 [] 返回对象
data 类型 是否返回 示例值 描述
name string 是 PC商品主图 资源样式名称
code string 是 index_goods_image 资源样式编码
platform integer 是 0 资源样式平台(自定义)
quality integer 否 100 资源图片质量 0=系统默认
type integer 否 jpg 资源输出格式，空则原样输出
style string 否 demo 第三方OSS样式
status integer 否 1 资源样式状态 0=禁用 1=启用
scale object 是 [] 缩略和裁剪数组
storage_style_id integer 是 7 资源样式编号
scale 类型 是否返回 示例值 描述
size array 是 ["800","800"] 资源缩略尺寸
crop array 是 ["100","100"] 资源裁剪尺寸

响应示例：

  1. {
  2.   "status": 200,
  3.   "message": "success",
  4.   "data": {
  5.     "name": "PC商品主图",
  6.     "code": "index_goods_image",
  7.     "platform": 0,
  8.     "quality": 100,
  9.     "type": "jpg",
  10.     "style": "demo",
  11.     "status": 1,
  12.     "scale": {
  13.       "size": [
  14.         "800",
  15.         "800"
  16.       ],
  17.       "crop": [
  18.         "100",
  19.         "100"
  20.       ]
  21.     },
  22.     "storage_style_id": 7
  23.   }
  24. }

备注:

  1. 参数size和crop可链式操作，请求时参数的前后顺序决定图片的处理先后顺序不同。

  2. 参数size和crop使用最多2位的数组，第一位表示宽度，第二位表示高度。

  3. 参数size和crop可以只处理数组中的某一位，例如：[800]表示只处理宽度，高度则自适应，再例如：[0,800]表示只处理高度，宽度则自适应。所以0或空则表示某位不处理(当然也可以是二位都是0)。

  4. 参数quality值为0或空时表示系统默认质量输出。

  5. 参数style值不为空时表示启用第三方OSS样式功能，所以其余参数都被会忽略。