接口描述:

  • 添加一个资源样式。

请求 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. 参数sizecrop可链式操作,请求时参数的前后顺序决定图片的处理先后顺序不同。

  2. 参数sizecrop使用最多2位的数组,第一位表示宽度,第二位表示高度

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

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

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

文档更新时间: 2018-06-06 00:28