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