Skip to content

获取目录文件列表(新版),支持分页、搜索

浏览服务器文件系统,查看指定目录下的文件和子目录列表,支持分页和搜索。

POST
https://your-panel.example.com:8888/files
更新于 查看 Markdown

Request bodyX-WWW-FORM-URLENCODEDrequired

  • request_timestringrequired

    Unix 时间戳。

  • request_tokenstringrequired

    按 API 概览生成的签名。

  • actionGetDirNewrequired

    具体操作名称。

  • pathoptionalstring

    目录路径,默认 /www/wwwroot

  • searchoptionalstring

    搜索关键词,匹配文件名

  • alloptionalstring

    传任意值触发全量搜索模式

  • poptionalinteger

    页码,默认 1

Returns

default

接口响应,业务状态见下方详细说明。

JSON
  • pathoptionalstring

    当前路径

  • diroptionalstring

    子目录列表,每项含 nm(名称)、sz(大小)、mt(修改时间戳)、acc(权限)、user(属主)

  • pageoptionalstring

    分页 HTML 片段

  • storeoptionalarray ofunknown

    收藏夹目录列表

  • file_recycleoptionalboolean

    回收站状态

各操作详细说明

GetDirNewaction=GetDirNew获取目录文件列表(新版),支持分页、搜索

浏览服务器文件系统,查看指定目录下的文件和子目录列表,支持分页和搜索。

  • 路由:POST /files
  • action:GetDirNew

输入参数

参数名称 必选 类型 描述
action 是 String 固定值 GetDirNew
path 否 String 目录路径,默认 /www/wwwroot
search 否 String 搜索关键词,匹配文件名
all 否 String 传任意值触发全量搜索模式
p 否 Integer 页码,默认 1

输出参数

参数名称 类型 描述
path String 当前路径
dir Array<Object> 子目录列表,每项含 nm(名称)、sz(大小)、mt(修改时间戳)、acc(权限)、user(属主)
page String 分页 HTML 片段
store Array 收藏夹目录列表
file_recycle Boolean 回收站状态

示例

请求

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

action=GetDirNew&path=/www/wwwroot

响应

{
  "store": [],
  "file_recycle": false,
  "page": "<div><span class='Pcurrent'>1</span><span class='Pnumber'>1/1</span><span class='Pline'>从1-3条</span><span class='Pcount'>共3条</span></div>",
  "path": "/www/wwwroot",
  "dir": [
    {"nm": "api-demo.bt.local", "sz": 4096, "mt": 1779451143, "acc": "755", "user": "www", "lnk": "", "durl": "", "cmp": 0, "fav": "0", "rmk": "", "top": 0, "sn": "api-demo.bt.local"},
    {"nm": "default", "sz": 4096, "mt": 1779433215, "acc": "755", "user": "root", "lnk": "", "durl": "", "cmp": 0, "fav": "0", "rmk": "", "top": 0, "sn": "default"}
  ]
}
Navigation

Type to search…

↑↓ navigate↵ selectEsc close