1. 文件列表
123 云盘
  • 首页
  • 官方接口
    • 接入指南
      • 开发者接入
        • 获取access_token
    • API列表
      • 文件管理
        • 上传
        • 重命名
        • 删除
        • 还原
        • 文件详情
        • 文件列表
          • 获取文件列表(推荐)
            GET
          • 获取文件列表(旧)
            GET
        • 移动
          • 移动
        • 下载
      • 图床
        • 上传图片
          • 上传流程说明
          • 创建目录
          • 创建文件
          • 获取上传地址
          • 上传分片
          • 上传完毕
          • 异步轮询获取上传结果
        • 复制云盘图片
          • 创建复制任务
          • 获取复制任务详情
          • 获取复制失败文件列表
        • 获取目录/图片信息
          • 获取目录/图片详情
          • 获取目录/图片列表
        • 移动图片
          • 移动图片
        • 删除图片
          • 删除图片
        • 图床离线迁移
        • 重命名目录/图片
          • 重命名目录/图片
  • 补充文档
    • 申请clientID和clientSecret
    • 令牌access_token保存方案
  • Java 对接示例
  • Python 对接示例
  • JavaScript 对接示例
  1. 文件列表

获取文件列表(推荐)

开发中
GET
/api/v2/file/list

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://open-api.123pan.com/api/v2/file/list?parentFileId=27597878&limit=100' \
--header 'Platform: open_platform' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJUCI6IjE5Mi4xNjguMi44OSIsImRldmljZUlkIjoiZ2N4MDl3anN0aGtLbzZIZHBEdk1yRXl1Sm4xNFNUTk8oOiktMSg6KS0xIiwiZGV2aWNlTW9kZWwiOiIiLCJkZXZpY2VOYW1lIjoib3BlbnBsYXRmb3JtX2RldmljZW5hbWUiLCJkZXZpY2VUeXBlIjoiIiwiZXhwIjoxNzg1MDY2NjM2LCJpYXQiOjE3ODQ0NjE4MzYsImlkIjoxODI5NjA0NjQxLCJsb2dpbl90eXBlIjo2LCJtYWlsIjoiOTc5NzIzMjBAcXEuY29tIiwibmlja25hbWUiOiLpo57nv5RGRUlYSUFORyIsInBsYXRmb3JtIjo3LCJyZW1lbWJlciI6MSwidXNlcm5hbWUiOjE1MDAyMDA5NDUxLCJ2IjowfQ.WfKbATQ7sAC61XmqY6mKdnVhil5RW24EbjmdO1rA7G4' \
--header 'Content-Type: application/json' \
--data ''

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "message": "ok",
    "data": {
        "lastFileId": -1,
        "fileList": [
            {
                "fileId": 27597881,
                "filename": "feixiang-icon-256.png",
                "parentFileId": 27597878,
                "type": 0,
                "etag": "de9e0a75df3e82f318b4590f6742852e",
                "size": 29790,
                "category": 3,
                "status": 0,
                "punishFlag": 0,
                "s3KeyFlag": "1813002765-0",
                "storageNode": "m106",
                "trashed": 0,
                "createAt": "2025-11-26 14:47:19",
                "updateAt": "2025-11-26 14:47:19"
            }
        ]
    },
    "x-traceID": "ae12b4c4-b90f-4cae-9635-605fe032adc0_kong-db-f7c8c6d76-qfwqw"
}
上一页
获取access_token
下一页
获取文件列表(旧)
Built with