获取文件夹内容和下载文件
该接口用于获取文件夹内容和下载文件，如果传入的 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>'
Header
| 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
参见 全局错误码