1. 目录解析
云盘解析专业版 API
  • 解析接口
    • 解析分享链接(JSON)
      GET
    • 解析分享链接(重定向)
      GET
    • 根据类型和Key解析(重定向)
      GET
    • 根据类型和Key解析(带文件名重定向)
      GET
    • 根据类型和Key解析(JSON)
      GET
    • 获取链接信息
      GET
    • 检查链接有效性
      GET
  • 目录解析
    • 获取目录文件列表
      GET
    • 目录文件下载(重定向)
      GET
    • 获取目录文件下载信息
      GET
    • 目录文件预览(重定向)
      GET
    • 获取支持目录解析的网盘列表
      GET
  • 短链接口
    • 短链下载(重定向)
      GET
    • 短链下载(带文件名重定向)
      GET
    • 短链预览
      GET
    • 短链解析(JSON)
      GET
  • 预览接口
    • 预览媒体文件(按类型和Key)
      GET
    • 预览媒体文件(按URL)
      GET
  • 统计信息
    • 获取统计信息
      GET
  • 网盘列表
    • 获取已配置的网盘列表
      GET
    • 获取所有支持的网盘列表
      GET
  • 数据模型
    • CacheLinkInfo
    • FileInfo
    • LinkInfoResp
    • ShareLinkInfo
    • FileDownInfoResp
    • AuthInfoResp
    • AuthTypeInfo
    • AuthField
    • StatisticsInfo
    • PanInfo
    • JsonResult
    • ErrorResponse
  1. 目录解析

获取目录文件列表

GET
/v2/getFileList
本接口仅适用于 https://189.qaiu.top
获取分享链接中的文件列表(适用于目录分享)。需要鉴权但不消耗额度。返回的每个文件项中 parserUrl 和 previewUrl 已自动拼接 token 参数,可直接用于下载或预览
注意‼️请不要试图自行构造目录响应接口里的下载直链parserUrl,正常流程是请求获取目录文件列表接口,拿到文件对象里parserUrl,如果是子目录 可以继续调用parserUrl递归遍历,如果是文件则作为302下载链接。本章节只需要对接当前接口即可。
如何区分是子目录还是文件?根据type字段,文件是file或者扩展名,子目录是folder。
关于文件类型字段额外说明:fileType = "folder" 是判断某条记录是否为目录的唯一标准语义(前端通过此字段判断是否展示为可展开的目录,并用 parserUrl 递归获取子文件列表)。但存在少数解析器的赋值不规范(如 LzTool 用了图标名,LeTool 对普通文件用了原始整数),属于实现层面的不一致。

请求参数

Authorization
API Key
在 header 添加参数
X-API-Key
示例:
X-API-Key: ********************
or
API Key
在 query 添加参数
token
示例:
token: ********************
or
Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/v2/getFileList?url=undefined&pwd=undefined&dirId=undefined&uuid=undefined&stoken=undefined' \
--header 'X-API-Key: <api-key>'

返回响应

🟢200
application/json
获取成功
Bodyapplication/json

示例
[
    {
        "fileName": "file.zip",
        "fileId": "123456",
        "fileIcon": "string",
        "size": 1024000,
        "sizeStr": "1MB",
        "fileType": "zip",
        "filePath": "/folder/file.zip",
        "createTime": "2025-01-21 10:00:00",
        "updateTime": "2025-01-21 11:00:00",
        "createBy": "string",
        "description": "string",
        "downloadCount": 10,
        "panType": "lz",
        "parserUrl": "string",
        "previewUrl": "string",
        "hash": "string",
        "extParameters": {
            "property1": "string",
            "property2": "string"
        }
    }
]
🟠401
🔴500
修改于 2026-04-10 23:17:03
上一页
检查链接有效性
下一页
目录文件下载(重定向)
Built with