You need to enable JavaScript to run this app.
导航
获取文件列表
最近更新时间:2023.09.18 20:30:23首次发布时间:2023.09.18 20:30:23

本接口名称为list_file

请求参数

名称

类型

是否必选

默认值

描述

workspace_id

int

工作区 ID。

prefix

String

服务端路径,需要是 1 个文件夹

filter_in

String

默认值为空,表示默认不带任何过滤条件

过滤条件。设置关键字,系统将按照关键字在本层文件夹进行搜索。

order_type

String

asc

排序方式,取值范围如下:

  • asc(默认值):升序
  • desc:降序

order_field

String

name

排序所依据的字段,取值范围如下:

  • name(默认值):根据名称排序
  • mtime:根据最后修改时间排序

page_num

Integer

1

分页页码。从 1 开始,默认为 1。

page_size

Integer

10

单页展示的文件数量,最小值为 1,默认值为 10 。

isp

string

ct

传输选择的运营商,取值范围如下:

  • ct:中国电信
  • un:中国联通
  • cm:中国移动

返回参数

名称

类型

描述

total_num

Integer

所有符合条件的文件和子目录个数.

files

[]FileInfo

文件列表。
具体参数解释见FileInfo

FileInfo

名称

类型

描述

name

String

文件在服务端的路径。

size

Int64

上传的文件大小,单位为字节。

mtime:

Int64

文件最后修改时间,单位为微秒。

md5

/

文件内容的 md5 信息。md5 校验消耗性能,暂不支持。

type

String

文件类型。取值范围如下:

  • file:文件;
  • dir:文件目录。

异常列表

异常

说明

Exception: invalid response status [404] when list dir D/testss

prefix 需要是 1 个存在的文件夹。

调用示例

请参见 list_file_demo.py