获取资源缩略图实际路径

接口描述:

  • 获取资源缩略图实际路径。

请求 URL:

  • http|https://host/api/v1/storage/method/get.storage.thumb.url/

请求方式:

  • GET
  • POST

是否授权:

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
url string min:0 …(过长,省略) 资源外链地址
code string max:32 index_goods_image 资源样式编码
size array max[]:2 [800,800] 资源缩略尺寸
crop array max[]:2 [100,100] 资源裁剪尺寸
quality integer between:0,100 100 资源图片质量
type string 见附属 A jpg 资源输出格式,空则原样输出
style string max:64 demo 第三方OSS样式

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

请求示例:

  1. {
  2. "url": "careyshop.oruei.com/uploads/files/20180602/a918302cd8f701c0e4f45d16b32fc8e2.jpg?type=careyshop",
  3. "code": "index_goods_image",
  4. "size": [0,300],
  5. "crop": [100,0],
  6. "quality": 100,
  7. "type": "png",
  8. "style": ""
  9. }

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
url string …(过长,省略) 资源外链地址
url_prefix string …(过长,省略) 带前缀的资源外链地址

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "url": "careyshop.oruei.com/uploads/files/20180602/4f45d16b32fc8e2/5bd47d3283a40c5272a22443fe02b9ab3c167495.png",
  6. "url_prefix": "http://careyshop.oruei.com/uploads/files/20180602/4f45d16b32fc8e2/5bd47d3283a40c5272a22443fe02b9ab3c167495.png"
  7. }
  8. }

备注:

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

  2. 参数code所获取的系统设置参数权限小于请求参数,如果请求参数也存在相同参数则会被覆盖。

  3. 部分备注可参考「添加一个资源样式」