获取文件列表

GET

/v1/files

获取当前用户的文件列表。

查询参数：

keyword — 文件名搜索

category — 按类型筛选（1=视频, 2=音频, 3=图片, 4=文档, 5=种子, 6=其他）

status — 按状态筛选

page / page_size — 分页

请求参数

Authorization

API Key

在 header 添加参数

app-key

示例：

app-key: ********************

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.jieshuo.cn/v1/files?search=undefined&category=undefined&upload_id=undefined&order_by=undefined&order=undefined&page=undefined&page_size=undefined' \
--header 'x-code;' \
--header 'app-key: <api-key>'

返回响应

🟢200OK

application/json

Successful Response

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "Success",
    "data": {
        "items": [
            {
                "file_id": "string",
                "file_name": "string",
                "original_name": "string",
                "file_hash": "string",
                "category": 0,
                "category_name": "other",
                "suffix": "string",
                "file_size": 0,
                "meta_data": {
                    "property1": "string",
                    "property2": "string"
                },
                "created_at": "2019-08-24T14:15:22.123Z"
            }
        ],
        "total": 0,
        "page": 1,
        "page_size": 20
    }
}

🟠422Parameter Error

修改于 2026-07-10 07:58:12

获取文件导入/传输进度

获取存储用量