文件列表（分页）

GET

/api/file/list

文件管理

最后修改时间：2026-06-20 08:01:30

查询文件列表

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/file/list?bucket=undefined&creatorId=undefined&displayName=undefined&extension=undefined&fileNo=undefined&folderId=undefined&kind=undefined&originalName=undefined&provider=undefined&status=undefined&visibility=undefined&page=undefined&size=undefined' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200成功

application/json

文件列表分页响应（对齐参考项目返回结构）

Bodyapplication/json

示例

{
    "current": 0,
    "records": [
        {
            "bucket": "string",
            "createdAt": "string",
            "creator": {
                "id": 0,
                "nickName": "string",
                "userName": "string"
            },
            "deletedAt": "string",
            "deletedBy": 0,
            "displayName": "string",
            "duration": 0,
            "etag": "string",
            "extension": "string",
            "fileNo": "string",
            "folder": {
                "id": 0,
                "name": "string",
                "parentId": 0,
                "slug": "string",
                "sort": 0,
                "visibility": "string"
            },
            "height": 0,
            "id": 0,
            "kind": "string",
            "metadata": null,
            "mimeType": "string",
            "objectKey": "string",
            "originalName": "string",
            "pageCount": 0,
            "provider": "string",
            "publicToken": "string",
            "publicUrlExpiresAt": "string",
            "purgeError": "string",
            "purgeStatus": "string",
            "purgedAt": "string",
            "remark": "string",
            "size": 0,
            "status": "string",
            "tags": null,
            "updatedAt": "string",
            "visibility": "string",
            "width": 0
        }
    ],
    "size": 0,
    "summary": {
        "privateCount": 0,
        "publicCount": 0,
        "total": 0
    },
    "total": 0
}

修改于 2026-06-20 08:01:30

更新可见性

公开分享链接下载（无需登录）