接口描述:

  • 获取一个资源或资源目录。

请求 URL:

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

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
storage_id integer gt:0 51 资源编号

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
参数名 类型 是否返回 示例值 描述
storage_id integer 51 资源编号
parent_id integer 0 所属资源编号
name string 3a220004b7106964.png 资源名称
mime string image/png 资源Mime
ext string png 资源后缀
size string 40295 资源大小
pixel array ["width":855,"height":419] 资源像素,非图片资源则为空
hash string …(太长省略) 资源Hash值
path string …(太长省略) 资源内部路径(资源标识)
url string …(太长省略) 资源外链地址
protocol string aliyun 资源协议(模块名)
type integer 0 资源类型 0=图片 1=附件 2=目录
cover string 资源目录封面(只有目录才会有封面)
sort integer 50 排序值
is_default integer 0 默认目录 0=否 1=是
create_time datetime 2018-05-28 23:20:31 创建时间
update_time datetime 2018-05-28 23:20:31 更新时间

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "storage_id": 51,
  6. "parent_id": 0,
  7. "name": "3a220004b7106964.png",
  8. "mime": "image/png",
  9. "ext": "png",
  10. "size": 40295,
  11. "pixel": {
  12. "width": 855,
  13. "height": 419
  14. },
  15. "hash": "4D5336213F769F2FC3D93A57F2E3E4ED",
  16. "path": "uploads/files/20180528/3a220004b7106964.png",
  17. "url": "careyshop.oss-cn-hangzhou.aliyuncs.com/uploads/files/20180528/3a220004b7106964.png?type=aliyun",
  18. "protocol": "aliyun",
  19. "type": 0,
  20. "cover": "",
  21. "sort": 50,
  22. "is_default": 0,
  23. "create_time": "2018-05-28 23:20:31",
  24. "update_time": "2018-05-28 23:20:31"
  25. }
  26. }

备注:

  1. 资源和资源目录的结构是相同的,区别无非就是有的字段不一定有内容而已。可以通过type字段判断。
文档更新时间: 2018-06-03 00:00