列出文件

GET

/file

列出给定 URI 下的文件，如果 URI 包含搜索条件，也可以用于搜索文件。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Header 参数

返回响应

🟢200Success

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location '/file?uri=cloudreve%3A%2F%2Fmy%2FLuke%27s%20AMA&page=0&page_size=50&order_by=created_at&order_direction=asc&next_page_token=4%7CeyJpZCI6InJwR3pZMUY1In0%3D' \
--header 'X-Cr-Purchase-Ticket: 1f63aa26-edc0-40ce-950a-cb4d4323158e' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "data": {
        "files": [
            {
                "type": 1,
                "id": "N93dL8ig",
                "name": "Takeout",
                "permission": null,
                "created_at": "2025-02-13T20:14:15+08:00",
                "updated_at": "2025-02-13T20:17:36+08:00",
                "size": 0,
                "metadata": {},
                "path": "cloudreve://my/Luke's%20AMA/Takeout",
                "capability": "39/9",
                "owned": true,
                "primary_entity": "zOie"
            },
            {
                "type": 1,
                "id": "8zXA03uL",
                "name": "新建文件夹",
                "permission": null,
                "created_at": "2025-02-20T15:16:28+08:00",
                "updated_at": "2025-02-20T15:16:28+08:00",
                "size": 0,
                "metadata": {
                    "tag:asd": ""
                },
                "path": "cloudreve://my/Luke's%20AMA/%E6%96%B0%E5%BB%BA%E6%96%87%E4%BB%B6%E5%A4%B9",
                "capability": "39/9",
                "owned": true,
                "primary_entity": "zOie"
            },
            {
                "type": 0,
                "id": "8zXBp3UL",
                "name": "sample.psd",
                "permission": null,
                "created_at": "2025-05-22T14:34:24+08:00",
                "updated_at": "2025-05-22T14:34:24+08:00",
                "size": 3285099,
                "metadata": {
                    "thumb:disabled": ""
                },
                "path": "cloudreve://my/Luke's%20AMA/%E5%B0%8F%E7%88%B1%E8%B1%86.psd",
                "capability": "39/9",
                "owned": true,
                "primary_entity": "jYOAc8"
            }
        ],
        "parent": {
            "type": 1,
            "id": "0OmpAGUn",
            "name": "Luke's AMA",
            "permission": null,
            "created_at": "2024-01-27T10:58:20+08:00",
            "updated_at": "2025-05-23T15:09:15+08:00",
            "size": 0,
            "metadata": null,
            "path": "cloudreve://my/Luke's%20AMA",
            "capability": "39/9",
            "owned": true,
            "primary_entity": "zOie"
        },
        "pagination": {
            "page": 0,
            "page_size": 100,
            "is_cursor": true
        },
        "props": {
            "capability": "39/9",
            "max_page_size": 2000,
            "order_by_options": [
                "name",
                "size",
                "updated_at",
                "created_at"
            ],
            "order_direction_options": [
                "asc",
                "desc"
            ]
        },
        "context_hint": "5c6ea8a1-86e0-4967-8d40-598c6eb78bff",
        "mixed_type": false,
        "storage_policy": {
            "id": "Emta",
            "name": "minio",
            "type": "s3",
            "max_size": 0
        }
    },
    "msg": ""
}

修改于 2025-10-11 12:40:12

删除直链

列出文件活动