蓝奏云解析-优享版

蓝奏云·优享版十年磨一剑蓝奏团队倾力打造天下武功唯快不破

接口信息

GET / POST api.vsaa.cn/api/pan/lanzou/youxiang.php

Method

GET / POST

分类

网盘

Calls

KEY

无需 KEY

计费

免费

QPM

100/MIN

鉴权方式

无需密钥

作者

JanYun

请求参数

参数名	类型	必填	说明	示例
url	string	是	分享链接	https://www.ilanzou.com/s/LZYKq540
pwd	string	否	需要密码时必填
format	string	否	返回格式: detailed, simple, tree, flat	detailed

[
    {
        "name": "url",
        "type": "string",
        "required": true,
        "description": "分享链接",
        "example": "https://www.ilanzou.com/s/LZYKq540"
    },
    {
        "name": "pwd",
        "type": "string",
        "required": false,
        "description": "需要密码时必填",
        "example": ""
    },
    {
        "name": "format",
        "type": "string",
        "required": false,
        "description": "返回格式: detailed, simple, tree, flat",
        "example": "detailed"
    }
]

返回示例

{
    "code": 200,
    "msg": "解析成功",
    "meta": {
        "version": "2.0",
        "author": "603212202@qq.com (vsaa.cn)",
        "timestamp": "2026-09-03 13:29:49",
        "api_version": "v2"
    },
    "info": {
        "user": {
            "user_id": 3986477,
            "username": "166****0989",
            "account": "115787342",
            "avatar": "",
            "is_vip": 0,
            "vip_name": "",
            "share_num": 1,
            "attention_num": 1,
            "fans_num": 0
        },
        "share": {
            "share_id": 4466464,
            "share_url": "https://www.ilanzou.com/s/LZYKq540",
            "share_desc": "",
            "code": "",
            "add_time": "2026-09-03 13:29:27",
            "update_time": "2026-09-03 13:29:27",
            "is_buy": 0,
            "is_favorite": 0,
            "show_up_time": 1,
            "show_downloads": 1,
            "show_comments": 1,
            "show_stars": 1,
            "show_likes": 1
        }
    },
    "data": {
        "statistics": {
            "total_files": 7,
            "total_folders": 0,
            "total_items": 7,
            "total_size": 89,
            "total_size_formatted": "89 B",
            "average_file_size": "12.71 B"
        },
        "directory_trees": [
            {
                "id": "380240542",
                "name": "72K刷石机-by小红.litematic",
                "type": "folder",
                "level": 0,
                "files": [
                    {
                        "id": 39663162747,
                        "name": "72K石-by小红.litematic",
                        "type": "file",
                        "size": "6 B",
                        "size_bytes": 6,
                        "icon": "assets/images/tab_file/icon/error.png",
                        "update_time": "2026-09-03 13:29:00",
                        "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=5C6EE6FFE54052B7A4CF33A6D615C7CF&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=E4FE315C33DA019657EC607B4F79569D&auth=9BA5F1D1658E380BF8B89123A162C81508243770A8FA7D950E748B308073E820&shareId=LZYKq540",
                        "path": "72K刷石机-by小红.litematic/72K石-by小红.litematic"
                    },
                    {
                        "id": 39663162746,
                        "name": "主世界猪人塔QQDT版.litematic",
                        "type": "file",
                        "size": "36 B",
                        "size_bytes": 36,
                        "icon": "assets/images/tab_file/icon/error.png",
                        "update_time": "2026-09-03 13:29:00",
                        "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=8D68CA8C2F0E59AA993474D9D9271AD5&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=E4FE315C33DA019657EC607B4F79569D&auth=47204115077E15045B436EE29E2E92E108243770A8FA7D950E748B308073E820&shareId=LZYKq540",
                        "path": "72K刷石机-by小红.litematic/主世界猪人塔QQDT版.litematic"
                    }
                ],
                "folders": [],
                "file_count": 2,
                "folder_count": 0,
                "total_size": 42,
                "total_size_formatted": "42 B"
            },
            {
                "id": "380240541",
                "name": "恶魂农场收集.litematic",
                "type": "folder",
                "level": 0,
                "files": [
                    {
                        "id": 39663162743,
                        "name": "恶魂农场收集.litematic",
                        "type": "file",
                        "size": "40 B",
                        "size_bytes": 40,
                        "icon": "assets/images/tab_file/icon/error.png",
                        "update_time": "2026-09-03 13:29:00",
                        "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=234C4354DB5DB02BE34E7D54EA823C79&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=E28953B0042640B423B6939B7C5E5E75D978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                        "path": "恶魂农场收集.litematic/恶魂农场收集.litematic"
                    },
                    {
                        "id": 39663162742,
                        "name": "y0堆门恶魂农场 by Lemon_Iced.litematic",
                        "type": "file",
                        "size": "1 B",
                        "size_bytes": 1,
                        "icon": "assets/images/tab_file/icon/error.png",
                        "update_time": "2026-09-03 13:29:00",
                        "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=D6BEEAD2FF12EBD358F98F0541523DEF&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=829A7A788A04028BD877CB751171EAAAD978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                        "path": "恶魂农场收集.litematic/y0堆门恶魂农场 by Lemon_Iced.litematic"
                    },
                    {
                        "id": 39663162741,
                        "name": "desktop.ini",
                        "type": "file",
                        "size": "1 B",
                        "size_bytes": 1,
                        "icon": "assets/images/tab_file/icon/error.png",
                        "update_time": "2026-09-03 13:29:00",
                        "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=D0709D50F0ED14863A84CE5209F94C51&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=E4B7FBE61D232F1A9E3FA8E925647560D978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                        "path": "恶魂农场收集.litematic/desktop.ini"
                    },
                    {
                        "id": 39663162740,
                        "name": "y0切门恶魂农场 by Lemon_Iced.litematic",
                        "type": "file",
                        "size": "1 B",
                        "size_bytes": 1,
                        "icon": "assets/images/tab_file/icon/error.png",
                        "update_time": "2026-09-03 13:29:00",
                        "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=F084F767FAF7FB7BDB3A753313FB0C3A&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=BFCFADB6E9090AF4C39A593E292AA9ACD978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                        "path": "恶魂农场收集.litematic/y0切门恶魂农场 by Lemon_Iced.litematic"
                    },
                    {
                        "id": 39663162739,
                        "name": "18 层堆门恶魂农场 by Lemon_Iced.litematic",
                        "type": "file",
                        "size": "4 B",
                        "size_bytes": 4,
                        "icon": "assets/images/tab_file/icon/error.png",
                        "update_time": "2026-09-03 13:29:00",
                        "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=9261B348B5FB35C9A29D3C8DC0BD7940&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=A4DB432B21B09440D7AD5AB3256C03F7D978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                        "path": "恶魂农场收集.litematic/18 层堆门恶魂农场 by Lemon_Iced.litematic"
                    }
                ],
                "folders": [],
                "file_count": 5,
                "folder_count": 0,
                "total_size": 47,
                "total_size_formatted": "47 B"
            }
        ],
        "file_list": [
            {
                "id": 39663162747,
                "name": "72K石-by小红.litematic",
                "type": "file",
                "size": "6 B",
                "size_bytes": 6,
                "icon": "assets/images/tab_file/icon/error.png",
                "update_time": "2026-09-03 13:29:00",
                "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=5C6EE6FFE54052B7A4CF33A6D615C7CF&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=E4FE315C33DA019657EC607B4F79569D&auth=9BA5F1D1658E380BF8B89123A162C81508243770A8FA7D950E748B308073E820&shareId=LZYKq540",
                "path": "72K刷石机-by小红.litematic/72K石-by小红.litematic"
            },
            {
                "id": 39663162746,
                "name": "主世界猪人塔QQDT版.litematic",
                "type": "file",
                "size": "36 B",
                "size_bytes": 36,
                "icon": "assets/images/tab_file/icon/error.png",
                "update_time": "2026-09-03 13:29:00",
                "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=8D68CA8C2F0E59AA993474D9D9271AD5&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=E4FE315C33DA019657EC607B4F79569D&auth=47204115077E15045B436EE29E2E92E108243770A8FA7D950E748B308073E820&shareId=LZYKq540",
                "path": "72K刷石机-by小红.litematic/主世界猪人塔QQDT版.litematic"
            },
            {
                "id": 39663162743,
                "name": "恶魂农场收集.litematic",
                "type": "file",
                "size": "40 B",
                "size_bytes": 40,
                "icon": "assets/images/tab_file/icon/error.png",
                "update_time": "2026-09-03 13:29:00",
                "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=234C4354DB5DB02BE34E7D54EA823C79&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=E28953B0042640B423B6939B7C5E5E75D978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                "path": "恶魂农场收集.litematic/恶魂农场收集.litematic"
            },
            {
                "id": 39663162742,
                "name": "y0堆门恶魂农场 by Lemon_Iced.litematic",
                "type": "file",
                "size": "1 B",
                "size_bytes": 1,
                "icon": "assets/images/tab_file/icon/error.png",
                "update_time": "2026-09-03 13:29:00",
                "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=D6BEEAD2FF12EBD358F98F0541523DEF&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=829A7A788A04028BD877CB751171EAAAD978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                "path": "恶魂农场收集.litematic/y0堆门恶魂农场 by Lemon_Iced.litematic"
            },
            {
                "id": 39663162741,
                "name": "desktop.ini",
                "type": "file",
                "size": "1 B",
                "size_bytes": 1,
                "icon": "assets/images/tab_file/icon/error.png",
                "update_time": "2026-09-03 13:29:00",
                "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=D0709D50F0ED14863A84CE5209F94C51&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=E4B7FBE61D232F1A9E3FA8E925647560D978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                "path": "恶魂农场收集.litematic/desktop.ini"
            },
            {
                "id": 39663162740,
                "name": "y0切门恶魂农场 by Lemon_Iced.litematic",
                "type": "file",
                "size": "1 B",
                "size_bytes": 1,
                "icon": "assets/images/tab_file/icon/error.png",
                "update_time": "2026-09-03 13:29:00",
                "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=F084F767FAF7FB7BDB3A753313FB0C3A&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=BFCFADB6E9090AF4C39A593E292AA9ACD978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                "path": "恶魂农场收集.litematic/y0切门恶魂农场 by Lemon_Iced.litematic"
            },
            {
                "id": 39663162739,
                "name": "18 层堆门恶魂农场 by Lemon_Iced.litematic",
                "type": "file",
                "size": "4 B",
                "size_bytes": 4,
                "icon": "assets/images/tab_file/icon/error.png",
                "update_time": "2026-09-03 13:29:00",
                "download_url": "https://api.ilanzou.com/unproved/file/redirect?downloadId=9261B348B5FB35C9A29D3C8DC0BD7940&enable=1&devType=6&uuid=OrvDvozvN-1bhGfw6qUmW&timestamp=A1A8B1BFBF1DE0CFA54035BB76B69A77&auth=A4DB432B21B09440D7AD5AB3256C03F7D978C3FDC38860A58D0228B80720209A&shareId=LZYKq540",
                "path": "恶魂农场收集.litematic/18 层堆门恶魂农场 by Lemon_Iced.litematic"
            }
        ],
        "folder_list": []
    }
}

详细文档

蓝奏云解析-优享版

接口说明

本接口用于解析蓝奏云分享链接，返回分享内容的文件列表与目录结构信息，适用于需要集成蓝奏云文件解析能力的开发者场景。无需密钥即可调用，免费使用。

调用地址

/api/pan/lanzou/youxiang.php

请求方式

GET 或 POST

属性	说明
频率限制	每分钟约 100 次

鉴权说明

本接口无需密钥，直接调用即可。

请求参数

参数名	类型	必填	说明
url	string	是	蓝奏云分享链接，如 `https://www.ilanzou.com/s/LZYKq540`
pwd	string	否	分享链接的访问密码，需密码时填写
format	string	否	返回数据格式，默认为 `detailed`

format 参数取值说明：

取值	说明
detailed	完整信息，包含用户信息、分享信息及文件列表（默认）
simple	简化信息，仅返回文件基本信息
tree	树形结构，按文件夹层级返回
flat	扁平列表，返回所有文件平铺列表

成功响应示例

{
    "code": 200,
    "msg": "解析成功",
    "meta": {
        "version": "2.0",
        "author": "603212202@qq.com (vsaa.cn)",
        "timestamp": "2026-09-03 13:29:49",
        "api_version": "v2"
    },
    "info": {
        "user": {
            "user_id": 3986477,
            "username": "166****0989",
            "account": "115787342",
            "is_vip": 0
        },
        "share": {
            "share_id": 4466464,
            "share_url": "https://www.ilanzou.com/s/LZYKq540",
            "add_time": "2026-09-03 13:29:27"
        }
    },
    "data": {
        "statistics": {
            "total_files": 7,
            "total_folders": 0,
            "total_items": 7,
            "total_size_formatted": "89 B"
        },
        "directory_trees": [
            {
                "id": "380240542",
                "name": "72K刷石机-by小红.litematic",
                "type": "folder",
                "level": 0,
                "files": [
                    {
                        "id": 39663162747,
                        "name": "72K石-by小红.litematic",
                        "type": "file",
                        "size": "6 B",
                        "size_bytes": 6,
                        "path": "72K刷石机-by小红.litematic/72K石-by小红.litematic",
                        "download_url": "https://api.ilanzou.com/unproved/file/redirect?..."
                    }
                ],
                "folders": [],
                "file_count": 2,
                "folder_count": 0,
                "total_size_formatted": "42 B"
            }
        ],
        "file_list": [
            {
                "id": 39663162747,
                "name": "72K石-by小红.litematic",
                "type": "file",
                "size": "6 B",
                "size_bytes": 6,
                "path": "72K刷石机-by小红.litematic/72K石-by小红.litematic",
                "download_url": "https://api.ilanzou.com/unproved/file/redirect?..."
            }
        ],
        "folder_list": []
    }
}

响应字段说明

顶层字段

字段	类型	说明
code	integer	状态码，200 表示成功
msg	string	状态消息
meta	object	元数据信息
info	object	分享者与分享详情
data	object	文件数据主体

meta 字段

字段	类型	说明
meta.version	string	API 版本
meta.author	string	开发者联系方式
meta.timestamp	string	响应时间戳
meta.api_version	string	接口版本标识

info.user 字段

字段	类型	说明
user.user_id	integer	用户 ID
user.username	string	用户名（脱敏显示）
user.account	string	账号
user.is_vip	integer	是否会员，0=否，1=是

info.share 字段

字段	类型	说明
share.share_id	integer	分享 ID
share.share_url	string	分享链接
share.add_time	string	分享创建时间
share.update_time	string	分享更新时间

data.statistics 字段

字段	类型	说明
statistics.total_files	integer	文件总数
statistics.total_folders	integer	文件夹总数
statistics.total_items	integer	总项目数
statistics.total_size	number	总大小（字节）
statistics.total_size_formatted	string	格式化后的大小

directory_trees 节点字段

字段	类型	说明
id	string	节点唯一标识
name	string	名称
type	string	类型

错误响应示例

{
    "code": 0,
    "msg": "未提供调用密钥",
    "errcode": 11001
}

业务错误码说明

errcode	含义说明
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用

调用示例

终端 curl（bash）

curl -s "https://api.example.com/api/pan/lanzou/youxiang.php?url=https://www.ilanzou.com/s/LZYKq540"

PHP

// PHP
$url = "https://api.example.com/api/pan/lanzou/youxiang.php?url=https://www.ilanzou.com/s/LZYKq540";
echo file_get_contents($url);

注意事项

必须通过 HTTPS 协议调用本接口，HTTP 请求将被拒绝。
接口无频率限制提示，但实际限流阈值约为每分钟 100 次，短时间内高频调用可能导致请求被暂时拒绝，请合理控制调用节奏。
pwd 参数仅在分享链接设置了提取码时才需要传入，未设密码的分享链接直接忽略该字段即可，错误传入通常不影响解析结果。
format 参数决定返回结构：detailed 返回完整目录树与文件列表，simple 仅返回扁平文件清单，tree 返回纯目录树结构，flat 返回扁平化文件列表；未传时默认返回 detailed 格式，请按需选择以减少响应体积。
返回数据中的 download_url 包含临时签名参数（auth、timestamp 等），具有时效性，获取后请尽快用于下载，过期后需重新调用本接口获取新地址。
分享链接格式必须为标准蓝奏云 URL（如 https://www.ilanzou.com/s/xxxxxx），短链、无效链接或缺少分享标识符的请求将返回错误码。
本接口为免费服务，不对可用性、响应时间作任何保证，请勿用于对实时性要求极高的生产场景。

快速上手

curl -X POST 'https://api.example.com/api/pan/lanzou/youxiang.php' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.ilanzou.com/s/LZYKq540","format":"detailed"}' \
  | python3 -c "import sys,json; d=json.load(sys.stdin); print('success' if d['code']==0 else 'error')"

在线测试

请求地址

api.vsaa.cn/api/pan/lanzou/youxiang.php

Method

参数

url * pwd format

Response 等待中

// 结果将在此处显示

接口信息

详细文档

蓝奏云解析-优享版

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

顶层字段

meta 字段

info.user 字段

info.share 字段

data.statistics 字段

directory_trees 节点字段

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈