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

获取目录/图片列表

开发中
POST
/api/v1/oss/file/list

请求参数

Header 参数

Body 参数application/json

示例
{
    "parentFileId": "yk6baz03t0l000d7w33fxgeerx6xjnifDIYPDwaODqUzAGxvAdD2AY==",
    "limit": 100,
    "startTime": 1730390400,
    "endTime": 1730390400,
    "lastFileId": "ymjew503t0m000d7w32xzrcmko88fprvDIYPDwaODqUzAGxvAdD2AY==",
    "type": 1
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open-api.123pan.com/api/v1/oss/file/list' \
--header 'Platform: open_platform' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NjQ2NTk0NjYsImlhdCI6MTc2NDA1NDY2NiwiaWQiOjE4MTMwMDI3NjUsIm1haWwiOiJmZWl4aWFuZ25ldEBxcS5jb20iLCJuaWNrbmFtZSI6Iumjnue_lOS4reaWh-e9kSIsInVzZXJuYW1lIjoxNTExMjIyMDk1NSwidiI6MH0.N2YNoKyeGWt1TJLcpPN2WotzvymcEyUBd9eRbPZl7TU' \
--header 'Content-Type: application/json' \
--data-raw '{
    "parentFileId": "yk6baz03t0l000d7w33fxgeerx6xjnifDIYPDwaODqUzAGxvAdD2AY==",
    "limit": 100,
    "startTime": 1730390400,
    "endTime": 1730390400,
    "lastFileId": "ymjew503t0m000d7w32xzrcmko88fprvDIYPDwaODqUzAGxvAdD2AY==",
    "type": 1
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "message": "ok",
    "data": {
        "lastFileId": "-1",
        "fileList": [
            {
                "fileId": "ymjew503t0m000d7w32xzrcmko88fprvDIYPDwaODqUzAGxvAdD2AY==",
                "filename": "飞翔.png",
                "parentFileId": "yk6baz03t0l000d7w33fxgeerx6xjnifDIYPDwaODqUzAGxvAdD2AY==",
                "type": 0,
                "etag": "de9e0a75df3e82f318b4590f6742852e",
                "size": 29790,
                "status": 0,
                "s3KeyFlag": "1813002765-0",
                "storageNode": "m106",
                "createAt": "2025-12-01 17:46:03",
                "updateAt": "2025-12-01 17:46:03",
                "downloadURL": "https://vip.123pan.cn/1813002765/ymjew503t0m000d7w32xzrcmko88fprvDIYPDwaODqUzAGxvAdD2AY==.png",
                "ossIndex": 15,
                "totalTraffic": 0,
                "parentFilename": "飞翔图床目录",
                "extension": "png",
                "userSelfURL": "https://lianjie.feixiang.net/ymjew503t0m000d7w32xzrcmko88fprvDIYPDwaODqUzAGxvAdD2AY==.png"
            }
        ]
    },
    "x-traceID": "c97c5437-1e75-4d0c-9e93-9214a0af277d_kong-db-f7c8c6d76-bmppx"
}
上一页
获取目录/图片详情
下一页
移动图片
Built with