跳到正文
Navigation

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

POST
https://your-panel.example.com:8888/files

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

Request body application/x-www-form-urlencoded required

  • request_time
    string
    required

    Unix 时间戳。

  • request_token
    string
    required

    按 API 概览生成的签名。

  • action
    GetDirNew
    required

    具体操作名称。

  • path
    optional
    string

    目录路径,默认 /www/wwwroot

  • search
    optional
    string

    搜索关键词,匹配文件名

  • all
    optional
    string

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

  • p
    optional
    integer

    页码,默认 1

Returns

default

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

JSON
  • path
    optional
    string

    当前路径

  • dir
    optional
    string

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

  • page
    optional
    string

    分页 HTML 片段

  • store
    optional
    array of
    unknown

    收藏夹目录列表

  • file_recycle
    optional
    boolean

    回收站状态

各操作详细说明

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"}
  ]
}

Type to search…

↑↓ navigate↵ selectEsc close