云盘解析专业版 API 对接文档

189.qaiu.top — 聚合主流云盘直链解析服务，支持蓝奏云 / 夸克 / UC / 天翼 / 移动 / 联通 / 123 等 20+ 平台。

本文档为 https://189.qaiu.top 专用，与开源自建版接口有所不同，请勿混用。

一、鉴权

注册后在用户面板获取 API Key，每次请求二选一传入：

方式	示例
请求头（推荐）	`X-API-Key: your_api_key`
URL 参数	`?token=your_api_key`

/v2/linkInfo（链接详情）无需鉴权。/v2/getFileList（目录列表）需要鉴权但不消耗额度。其余解析接口每次请求消耗 1 次额度。

二、接口速查

Base URL：https://189.qaiu.top

接口	方法	路径	说明	消耗额度
解析 → 302 跳转	GET	`/parser?url={url}&pwd={pwd}`	直接重定向到直链，最常用	✅
解析 → 302（短链含文件名）	GET	`/d/{网盘标识}/{key}@{pwd}`	URL 携带文件名，便于浏览器识别	✅
解析 → JSON	GET	`/json/parser?url={url}&pwd={pwd}`	返回直链 JSON，程序对接用	✅
链接详情	GET	`/v2/linkInfo?url={url}&pwd={pwd}`	返回下载/预览/短链/统计等全量信息	❌
目录文件列表	GET	`/v2/getFileList?url={url}&pwd={pwd}`	返回文件夹内文件数组	❌
统计信息	GET	`/v2/statisticsInfo`	全站解析量统计	❌

三、JSON 返回格式

解析成功

{
  "code": 200,
  "msg": "success",
  "success": true,
  "data": {
    "shareKey": "lz:ia2cntg",
    "directLink": "https://xxx.lanzouf.com/xxxxxx",
    "cacheHit": true,
    "expires": "2026-05-18 12:00:00",
    "expiration": 86400000,
    "fileInfo": {
      "fileName": "demo.zip",
      "size": 1024000,
      "sizeStr": "1 MB",
      "fileType": "zip"
    }
  },
  "timestamp": 1747500000000
}

链接详情（linkInfo）

{
  "code": 200,
  "data": {
    "downLink": "https://189.qaiu.top/d/lz/ia2cntg",
    "apiLink": "https://189.qaiu.top/json/lz/ia2cntg",
    "viewLink": "https://189.qaiu.top/v2/view/lz/ia2cntg",
    "checkLink": "https://189.qaiu.top/...",
    "cacheHitTotal": 10,
    "parserTotal": 5,
    "sumTotal": 15,
    "shareLinkInfo": {
      "panName": "蓝奏云",
      "type": "lz",
      "shareKey": "ia2cntg"
    }
  }
}

目录文件列表（getFileList）

{
  "code": 200,
  "data": [
    {
      "fileName": "视频.mp4",
      "fileId": "xxx",
      "fileType": "mp4",        // "folder" 表示子目录
      "size": 102400000,
      "sizeStr": "97.6 MB",
      "panType": "lz",
      "parserUrl": "https://189.qaiu.top/d/lz/xxx?token=...",
      "previewUrl": "https://189.qaiu.top/v2/view/lz/xxx?token=..."
    }
  ]
}

四、网盘标识

标识	网盘	标识	网盘	标识	网盘
`lz`	蓝奏云	`iz`	蓝奏优享	`fj`	小飞机盘
`ye`	123 云盘	`cow`	奶牛快传	`fc`	亿方云
`ec`	移动云空间	`ws`	文叔叔	`ce`	Cloudreve
`pgd`	Google Drive	`pod`	OneDrive	`pwps`	WPS 云文档
`qk`	夸克云盘	`uc`	UC 云盘	`p189`	天翼云盘
`p139`	移动云盘	`pwo`	联通云盘

五、踩坑指南

⚠️ 1. 分享链接必须 URL 编码

分享链接里经常含 #、&、+、空格等特殊字符。# 后面的所有内容会被浏览器和服务器直接丢弃，是最常见的解析失败原因。

各语言编码方式：

⚠️ 2. 拿到直链 ≠ 可以直接下载（部分需带 Header）

部分网盘有防盗链，用 wget/aria2/IDM 下载时需要附带特定 Header，否则 403。

网盘	必带 Header
奶牛快传 `cow`	`Referer: https://cowtransfer.com/`
小飞机盘 `fj`	`User-Agent: {otherParam.UA}`
超星云盘 `pcx`	`Referer: https://pan-yz.chaoxing.com`

做法：调 /v2/linkInfo 接口，返回的 shareLinkInfo.otherParam 字段里有需要附带的 Header，整包透传给下载器：

⚠️ 3. 目录解析的正确流程

目录接口返回的每条记录中：

fileType == "folder" → 子目录，用 parserUrl 递归调用获取子文件列表

其他 → 文件，parserUrl 即为可直接 GET 的 302 下载链接（已自动携带 token）

getFileList(url)
  └── 遍历 data[]
        ├── fileType == "folder" → 用 parserUrl 继续调 getFileList
        └── fileType == "mp4/zip/..." → 直接 GET parserUrl 下载

不要自己拼接下载链接，直接用接口返回的 parserUrl。

单个文件建议单独分享，不要绕目录解析去拿单文件直链：目录解析多一次列表请求，速度更慢，子项有效期也更短。

⚠️ 4. 直链有时效，缓存命中时留意过期时间

cacheHit: true 表示直链来自缓存，注意 expires 字段。过期后直链会 403/404，重新调一次解析接口即可，无需做其他处理。

⚠️ 5. 关于额度

每次成功解析消耗 1 次额度（缓存命中也消耗）

/v2/linkInfo 和 /v2/getFileList 不消耗额度，可以用来做链接预检

短链下载（/x/:code）优先使用创建者额度

六、多语言示例

Python

JavaScript / Node.js

cURL

目录遍历（Python）

七、错误码

code	含义
200	成功
400	参数错误（url 缺失 / 格式不对）
401	API Key 无效或缺少
403	额度不足或无权限
500	解析失败（分享失效 / 网盘限制）