跳到主要内容
版本:latest

GetDir

获取指定路径下的目录和文件列表,支持分页、排序、搜索。返回每项的详细信息(大小、权限、修改时间等)。

  • 路由POST /files
  • actionGetDir

输入参数

参数名称必选类型描述
actionString固定值 GetDir
pathString目录路径,如 /www/wwwroot/testapi.bt.local
pInteger页码,默认 1
searchString搜索关键词
sortString排序字段:name/size/mtime/permission/owner

输出参数

参数名称类型描述
PATHString当前路径
DIRArray子目录列表,每项格式:name;size;mtime;permission;owner;...
FILESArray文件列表,格式同上
PAGEString分页 HTML
STOREArray收藏的路径列表
FILE_RECYCLEBoolean是否开启回收站

示例

请求

POST /files HTTP/1.1
Content-Type: application/x-www-form-urlencoded

request_time=1700000000&request_token=xxx&action=GetDir&path=/www/wwwroot/testapi.bt.local&p=1

响应

{
"PATH": "/www/wwwroot/testapi.bt.local",
"DIR": [],
"FILES": ["404.html;138;1779435866;644;www;;0;0;0;0;;0", "index.html;917;...;644;www;..."],
"PAGE": "<div>分页</div>",
"STORE": [],
"FILE_RECYCLE": false
}