多可文档平台API
文件夹及文件接口---得到子文件夹及文件列表
得到一个文件夹下的子文件夹和文件基本信息,不递归。
请求方式: GET(HTTP/HTTPS)
请求地址: /api/ff/list?fid=ID&token=ACCESS_TOKEN
参数说明:
参数 | 类型 | 必须 | 说明 |
token |
string |
是 |
调用接口凭证 |
fid |
string |
否 |
父文件夹ID,如果为空得到根节点文件夹 |
返回结果示例:
{
"errcode": 0,
"errmsg": "",
"files": [
{
"id": "X00029",
"name": "uploader.go",
"size": 12960,
"modTime": "2025-02-24 21:21:06",
"createAt": "2025-06-10 11:24:06",
"dataHash": "26c7c2bdf958f9af955597de5493e7c114b7e0a0",
"xdType": 1
},
{
"id": "X00031",
"name": "如何在防火墙中增加端口.pdf",
"size": 266169,
"modTime": "2025-06-10 11:23:15",
"createAt": "2025-06-10 11:24:06",
"dataHash": "15f0e7b69de3cf980618ae772721b706a40a4284",
"xdType": 1
}
],
"folders": [
{
"id": "F00551",
"name": "产品说明",
"size": 0,
"modTime": "",
"createAt": "2025-06-16 10:46:47",
"dataHash": "",
"xdType": 2
}
]
}
返回参数说明:
参数 | 类型 | 说明 |
errcode |
int32 |
出错返回码,为0表示成功,非0表示调用失败 |
errmsg |
string |
返回码提示语 |
files |
array |
子文件 |
folders |
array |
子文件夹 |
--- files folders对象字段 |
id |
string |
文件/文件夹ID |
name |
string |
文件/文件夹名称 |
size |
int64 |
文件大小 |
modTime |
string |
文件最后修改时间 |
createAt |
string |
文件/文件夹创建时间 |
dataHash |
string |
文件内容HASH值,二进制转十六进制字符串 |
xdType |
int8 |
1表示文件,2表示文件夹 |
权限要求:需要目标文件夹的【文件名称查看,文件夹查看】权限。