获取文件夹内容和下载文件

该接口用于获取文件夹内容和下载文件,如果传入的 path/ 结尾,即为获取文件夹内容,否则为下载文件。

获取文件夹内容

GET

接口路径:http://matpool.com:30100/v1/fs

示例:

curl --request GET \
  # 注意 path 以 / 结尾
  --url 'http://matpool.com:30100/v1/fs?path=/' \
  --header 'Authorization: Bearer <YOUR_TOKEN>'
Required Name Value Description
✔︎ Authorization Bearer <token> 用户鉴权

Query

Required Name Example Description
✔︎ path / 注意以 / 结束

Response

Normal

code = 0

示例:

{
  "code": 0,
  "msg": "",
  // 获取到的文件夹内容
  "infos": [
    {
      "name": "data",
      "size": 0,
      "createTime": {
        "seconds": 1560252217,
        "nanos": 452406567
      },
      "modTime": {
        "seconds": 1560252217,
        "nanos": 452406567
      },
      "ownerId": 0,
      "isDir": true
    },
    {
      "name": "picture.png",
      "size": 126187, // 大小,单位 byte
      "createTime": {
        "seconds": 1562642063,
        "nanos": 608753391
      },
      "modTime": {
        "seconds": 1562642063,
        "nanos": 608753391
      },
      "ownerId": 0,
      "isDir": false
    }
  ]
}

Exception

code = 1 || 7 || 15

参见 全局错误码

下载文件

GET

接口路径:http://matpool.com:30100/v1/fs

示例:

curl --request GET \
  # 注意 path 不以 / 结尾
  --url 'http://matpool.com:30100/v1/fs?path=/<FILENAME>' \
  --header 'Authorization: Bearer <YOUR_TOKEN>' \

Header

Required Name Value Description
✔︎ Authorization Bearer <token> 用户鉴权

Query

Required Name Example Description
✔︎ path /data.txt 注意不以 / 结束

Response

Normal

code = 0

返回文件内容,调用者可以写到本地存下来

Exception

code = 1 || 7 || 9 || 15

参见 全局错误码

上次修改: 2019-07-12 16:59