{ "openapi": "3.0.3", "info": { "title": "网盘快速下载服务 API", "description": "网盘快速下载服务 REST API 文档，支持多种网盘的分享链接解析，提供直链下载、预览、客户端下载链接等功能", "version": "1.0.0", "contact": { "name": "API Support", "url": "https://qaiu.top" } }, "servers": [ { "url": "http://localhost:6400", "description": "本地开发环境" }, { "url": "https://lzzz.qaiu.top", "description": "生产环境" } ], "tags": [ { "name": "解析接口", "description": "分享链接解析相关接口" }, { "name": "文件列表", "description": "文件列表相关接口" }, { "name": "预览接口", "description": "媒体文件预览相关接口" }, { "name": "客户端下载", "description": "客户端下载链接相关接口" }, { "name": "统计信息", "description": "统计信息相关接口" }, { "name": "网盘列表", "description": "支持的网盘列表接口" }, { "name": "版本信息", "description": "版本信息接口" }, { "name": "隔空喊话", "description": "隔空喊话相关接口" }, { "name": "快捷下载", "description": "快捷下载重定向接口" } ], "paths": { "/parser": { "get": { "tags": ["解析接口"], "summary": "解析分享链接（重定向）", "description": "解析分享链接并重定向到直链下载地址", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "分享链接", "schema": { "type": "string", "example": "https://pan.baidu.com/s/1test123" } }, { "name": "pwd", "in": "query", "required": false, "description": "提取码", "schema": { "type": "string", "example": "1234" } } ], "responses": { "302": { "description": "重定向到直链下载地址", "headers": { "nfd-cache-hit": { "description": "是否命中缓存", "schema": { "type": "string", "example": "true" } }, "nfd-cache-expires": { "description": "缓存过期时间", "schema": { "type": "string", "example": "2025-01-22 12:00:00" } }, "Location": { "description": "重定向地址", "schema": { "type": "string" } } } }, "500": { "description": "解析失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/json/parser": { "get": { "tags": ["解析接口"], "summary": "解析分享链接（JSON）", "description": "解析分享链接并返回JSON格式的直链信息", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "分享链接", "schema": { "type": "string", "example": "https://pan.baidu.com/s/1test123" } }, { "name": "pwd", "in": "query", "required": false, "description": "提取码", "schema": { "type": "string", "example": "1234" } } ], "responses": { "200": { "description": "解析成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CacheLinkInfo" } } } }, "500": { "description": "解析失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/{type}/{key}": { "get": { "tags": ["解析接口"], "summary": "根据类型和Key解析（重定向）", "description": "根据网盘类型和分享Key解析并重定向到直链", "parameters": [ { "name": "type", "in": "path", "required": true, "description": "网盘类型标识（如: lz, pan, cow等）", "schema": { "type": "string", "example": "lz" } }, { "name": "key", "in": "path", "required": true, "description": "分享Key，如果包含提取码，格式为 key@pwd", "schema": { "type": "string", "example": "ia2cntg" } } ], "responses": { "302": { "description": "重定向到直链下载地址", "headers": { "nfd-cache-hit": { "description": "是否命中缓存", "schema": { "type": "string" } }, "nfd-cache-expires": { "description": "缓存过期时间", "schema": { "type": "string" } }, "Location": { "description": "重定向地址", "schema": { "type": "string" } } } }, "500": { "description": "解析失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/json/{type}/{key}": { "get": { "tags": ["解析接口"], "summary": "根据类型和Key解析（JSON）", "description": "根据网盘类型和分享Key解析并返回JSON格式的直链信息", "parameters": [ { "name": "type", "in": "path", "required": true, "description": "网盘类型标识", "schema": { "type": "string", "example": "lz" } }, { "name": "key", "in": "path", "required": true, "description": "分享Key，如果包含提取码，格式为 key@pwd", "schema": { "type": "string", "example": "ia2cntg" } } ], "responses": { "200": { "description": "解析成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CacheLinkInfo" } } } }, "500": { "description": "解析失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/linkInfo": { "get": { "tags": ["解析接口"], "summary": "获取链接信息", "description": "获取分享链接的详细信息，包括下载链接、预览链接、统计信息等", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "分享链接", "schema": { "type": "string", "example": "https://pan.baidu.com/s/1test123" } }, { "name": "pwd", "in": "query", "required": false, "description": "提取码", "schema": { "type": "string", "example": "1234" } } ], "responses": { "200": { "description": "获取成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LinkInfoResp" } } } }, "500": { "description": "获取失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/getFileList": { "get": { "tags": ["文件列表"], "summary": "获取文件列表", "description": "获取分享链接中的文件列表（适用于目录分享）", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "分享链接", "schema": { "type": "string", "example": "https://pan.baidu.com/s/1test123" } }, { "name": "pwd", "in": "query", "required": false, "description": "提取码", "schema": { "type": "string", "example": "1234" } }, { "name": "dirId", "in": "query", "required": false, "description": "目录ID，用于获取指定目录下的文件", "schema": { "type": "string", "example": "dir123" } }, { "name": "uuid", "in": "query", "required": false, "description": "UUID，某些网盘需要此参数", "schema": { "type": "string", "example": "uuid123" } } ], "responses": { "200": { "description": "获取成功", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/FileInfo" } } } } }, "500": { "description": "获取失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/view/{type}/{key}": { "get": { "tags": ["预览接口"], "summary": "预览媒体文件（按类型和Key）", "description": "预览指定类型和Key的媒体文件（图片、视频等）", "parameters": [ { "name": "type", "in": "path", "required": true, "description": "网盘类型标识", "schema": { "type": "string", "example": "pan" } }, { "name": "key", "in": "path", "required": true, "description": "分享Key，如果包含提取码，格式为 key@pwd", "schema": { "type": "string", "example": "1test123" } } ], "responses": { "302": { "description": "重定向到预览页面", "headers": { "Location": { "description": "预览页面地址", "schema": { "type": "string" } } } }, "500": { "description": "预览失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/preview": { "get": { "tags": ["预览接口"], "summary": "预览媒体文件（按URL）", "description": "通过分享链接预览媒体文件", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "分享链接", "schema": { "type": "string", "example": "https://pan.baidu.com/s/1test123" } }, { "name": "pwd", "in": "query", "required": false, "description": "提取码", "schema": { "type": "string", "example": "1234" } } ], "responses": { "302": { "description": "重定向到预览页面", "headers": { "Location": { "description": "预览页面地址", "schema": { "type": "string" } } } }, "500": { "description": "预览失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/viewUrl/{type}/{param}": { "get": { "tags": ["预览接口"], "summary": "预览URL（目录预览）", "description": "预览目录中的文件，param为Base64编码的参数", "parameters": [ { "name": "type", "in": "path", "required": true, "description": "网盘类型标识", "schema": { "type": "string", "example": "pan" } }, { "name": "param", "in": "path", "required": true, "description": "Base64编码的参数JSON", "schema": { "type": "string", "example": "eyJmaWxlSWQiOiIxMjM0NTYifQ==" } } ], "responses": { "302": { "description": "重定向到预览页面", "headers": { "Location": { "description": "预览页面地址", "schema": { "type": "string" } } } }, "500": { "description": "预览失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/clientLinks": { "get": { "tags": ["客户端下载"], "summary": "获取所有客户端下载链接", "description": "获取所有支持的客户端格式的下载链接", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "分享链接", "schema": { "type": "string", "example": "https://pan.baidu.com/s/1test123" } }, { "name": "pwd", "in": "query", "required": false, "description": "提取码", "schema": { "type": "string", "example": "1234" } } ], "responses": { "200": { "description": "获取成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientLinkResp" } } } }, "500": { "description": "获取失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/clientLink": { "get": { "tags": ["客户端下载"], "summary": "获取指定类型的客户端下载链接", "description": "获取指定客户端类型的下载链接", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "分享链接", "schema": { "type": "string", "example": "https://pan.baidu.com/s/1test123" } }, { "name": "pwd", "in": "query", "required": false, "description": "提取码", "schema": { "type": "string", "example": "1234" } }, { "name": "clientType", "in": "query", "required": true, "description": "客户端类型 (curl, wget, aria2, idm, thunder, bitcomet, motrix, fdm, powershell)", "schema": { "type": "string", "enum": ["curl", "wget", "aria2", "idm", "thunder", "bitcomet", "motrix", "fdm", "powershell"], "example": "curl" } } ], "responses": { "200": { "description": "获取成功", "content": { "text/plain": { "schema": { "type": "string", "example": "curl -L -H \"User-Agent: Mozilla/5.0...\" -o \"test-file.zip\" \"https://example.com/file.zip\"" } } } }, "500": { "description": "获取失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/statisticsInfo": { "get": { "tags": ["统计信息"], "summary": "获取统计信息", "description": "获取系统统计信息，包括解析总数、缓存总数等", "responses": { "200": { "description": "获取成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatisticsInfo" } } } }, "500": { "description": "获取失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/getPanList": { "get": { "tags": ["网盘列表"], "summary": "获取支持的网盘列表", "description": "获取所有支持的网盘列表及其信息", "responses": { "200": { "description": "获取成功", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PanInfo" } } } } } } } }, "/v2/build-version": { "get": { "tags": ["版本信息"], "summary": "获取版本号", "description": "获取应用版本号", "responses": { "200": { "description": "获取成功", "content": { "text/plain": { "schema": { "type": "string", "example": "20250121_101530" } } } } } } }, "/v2/shout/submit": { "post": { "tags": ["隔空喊话"], "summary": "提交消息", "description": "提交一条隔空喊话消息，返回6位提取码", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["content"], "properties": { "content": { "type": "string", "description": "消息内容", "example": "Hello World!" } } } } } }, "responses": { "200": { "description": "提交成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonResult" }, "example": { "code": 200, "msg": "success", "success": true, "data": "123456", "timestamp": 1705896000000 } } } }, "500": { "description": "提交失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/shout/retrieve": { "get": { "tags": ["隔空喊话"], "summary": "检索消息", "description": "根据提取码检索消息", "parameters": [ { "name": "code", "in": "query", "required": true, "description": "6位提取码", "schema": { "type": "string", "pattern": "^[0-9]{6}$", "example": "123456" } } ], "responses": { "200": { "description": "检索成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShoutMessage" } } } }, "500": { "description": "检索失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/d/{type}/{key}": { "get": { "tags": ["快捷下载"], "summary": "下载重定向（短链）", "description": "短链形式的下载重定向，等同于 /:type/:key", "parameters": [ { "name": "type", "in": "path", "required": true, "description": "网盘类型标识", "schema": { "type": "string", "example": "lz" } }, { "name": "key", "in": "path", "required": true, "description": "分享Key，如果包含提取码，格式为 key@pwd", "schema": { "type": "string", "example": "ia2cntg" } } ], "responses": { "302": { "description": "重定向到直链下载地址", "headers": { "Location": { "description": "重定向地址", "schema": { "type": "string" } } } }, "500": { "description": "解析失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v2/redirectUrl/{type}/{param}": { "get": { "tags": ["快捷下载"], "summary": "重定向下载URL（目录文件）", "description": "重定向到目录中指定文件的下载地址，param为Base64编码的参数", "parameters": [ { "name": "type", "in": "path", "required": true, "description": "网盘类型标识", "schema": { "type": "string", "example": "pan" } }, { "name": "param", "in": "path", "required": true, "description": "Base64编码的参数JSON", "schema": { "type": "string", "example": "eyJmaWxlSWQiOiIxMjM0NTYifQ==" } } ], "responses": { "302": { "description": "重定向到直链下载地址", "headers": { "Location": { "description": "重定向地址", "schema": { "type": "string" } } } }, "500": { "description": "解析失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } } }, "components": { "schemas": { "CacheLinkInfo": { "type": "object", "properties": { "shareKey": { "type": "string", "description": "缓存key: type:ShareKey", "example": "lz:ia2cntg" }, "directLink": { "type": "string", "description": "解析后的直链", "example": "https://example.com/download/file.zip" }, "cacheHit": { "type": "boolean", "description": "是否命中缓存", "example": false }, "expires": { "type": "string", "description": "到期时间 yyyy-MM-dd hh:mm:ss", "example": "2025-01-22 12:00:00" }, "expiration": { "type": "integer", "format": "int64", "description": "有效期（毫秒）", "example": 86400000 }, "fileInfo": { "$ref": "#/components/schemas/FileInfo" } } }, "FileInfo": { "type": "object", "properties": { "fileName": { "type": "string", "description": "文件名", "example": "file.zip" }, "fileId": { "type": "string", "description": "文件ID", "example": "123456" }, "fileIcon": { "type": "string", "description": "文件图标", "example": "icon.png" }, "size": { "type": "integer", "format": "int64", "description": "文件大小(byte)", "example": 1024000 }, "sizeStr": { "type": "string", "description": "文件大小字符串", "example": "1MB" }, "fileType": { "type": "string", "description": "文件类型", "example": "zip" }, "filePath": { "type": "string", "description": "文件路径", "example": "/folder/file.zip" }, "createTime": { "type": "string", "description": "创建(上传)时间 yyyy-MM-dd HH:mm:ss格式", "example": "2025-01-21 10:00:00" }, "updateTime": { "type": "string", "description": "上次修改时间", "example": "2025-01-21 11:00:00" }, "createBy": { "type": "string", "description": "创建者", "example": "user123" }, "description": { "type": "string", "description": "文件描述" }, "downloadCount": { "type": "integer", "description": "下载次数", "example": 10 }, "panType": { "type": "string", "description": "网盘标识", "example": "lz" }, "parserUrl": { "type": "string", "description": "nfd下载链接(可能获取不到)" }, "previewUrl": { "type": "string", "description": "预览地址" }, "hash": { "type": "string", "description": "文件hash默认类型为md5" }, "extParameters": { "type": "object", "description": "扩展参数", "additionalProperties": true } } }, "LinkInfoResp": { "type": "object", "properties": { "downLink": { "type": "string", "description": "下载链接", "example": "http://127.0.0.1:6400/d/pan/1test123" }, "apiLink": { "type": "string", "description": "API链接", "example": "http://127.0.0.1:6400/json/pan/1test123" }, "viewLink": { "type": "string", "description": "预览链接", "example": "http://127.0.0.1:6400/v2/view/pan/1test123" }, "cacheHitTotal": { "type": "integer", "description": "缓存命中总数", "example": 10 }, "parserTotal": { "type": "integer", "description": "解析总数", "example": 5 }, "sumTotal": { "type": "integer", "description": "总次数", "example": 15 }, "shareLinkInfo": { "$ref": "#/components/schemas/ShareLinkInfo" } } }, "ShareLinkInfo": { "type": "object", "properties": { "shareKey": { "type": "string", "description": "分享键", "example": "1test123" }, "panName": { "type": "string", "description": "网盘名称", "example": "百度网盘" }, "type": { "type": "string", "description": "分享类型", "example": "pan" }, "sharePassword": { "type": "string", "description": "分享密码（如果存在）", "example": "1234" }, "shareUrl": { "type": "string", "description": "原始分享链接", "example": "https://pan.baidu.com/s/1test123" }, "standardUrl": { "type": "string", "description": "规范化的标准链接", "example": "https://pan.baidu.com/s/1test123" }, "otherParam": { "type": "object", "description": "其他参数", "additionalProperties": true } } }, "ClientLinkResp": { "type": "object", "properties": { "success": { "type": "boolean", "description": "是否成功", "example": true }, "error": { "type": "string", "description": "错误信息" }, "directLink": { "type": "string", "description": "直链URL", "example": "https://example.com/file.zip" }, "fileName": { "type": "string", "description": "文件名", "example": "test-file.zip" }, "fileSize": { "type": "integer", "format": "int64", "description": "文件大小", "example": 1024000 }, "clientLinks": { "type": "object", "description": "所有客户端下载链接", "additionalProperties": { "type": "string" }, "example": { "CURL": "curl -L -H \"User-Agent: Mozilla/5.0...\" -o \"test-file.zip\" \"https://example.com/file.zip\"", "POWERSHELL": "$session = New-Object Microsoft.PowerShell.Commands.WebRequestSession...", "ARIA2": "aria2c --header=\"User-Agent: Mozilla/5.0...\" --out=\"test-file.zip\" \"https://example.com/file.zip\"" } }, "supportedClients": { "type": "object", "description": "支持的客户端类型列表", "additionalProperties": { "type": "string" }, "example": { "curl": "cURL 命令", "wget": "wget 命令", "aria2": "Aria2" } }, "parserInfo": { "type": "string", "description": "解析信息", "example": "百度网盘 - pan" } } }, "StatisticsInfo": { "type": "object", "properties": { "parserTotal": { "type": "integer", "description": "解析总数", "example": 1000 }, "cacheTotal": { "type": "integer", "description": "缓存总数", "example": 500 }, "total": { "type": "integer", "description": "总次数", "example": 1500 } } }, "PanInfo": { "type": "object", "properties": { "name": { "type": "string", "description": "网盘名", "example": "蓝奏云" }, "type": { "type": "string", "description": "网盘标识", "example": "lz" }, "shareUrlFormat": { "type": "string", "description": "分享链接格式", "example": "https://www.lanzou*.com/s/{shareKey}" }, "url": { "type": "string", "description": "网盘域名地址", "example": "https://www.lanzou.com" } } }, "ShoutMessage": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "description": "消息ID" }, "code": { "type": "string", "description": "6位提取码", "example": "123456", "pattern": "^[0-9]{6}$" }, "content": { "type": "string", "description": "消息内容", "example": "Hello World!" }, "ip": { "type": "string", "description": "发送者IP", "example": "127.0.0.1" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "example": "2025-01-21T10:00:00" }, "expireTime": { "type": "string", "format": "date-time", "description": "过期时间", "example": "2025-01-22T10:00:00" }, "isUsed": { "type": "boolean", "description": "是否已使用", "example": false } } }, "JsonResult": { "type": "object", "properties": { "code": { "type": "integer", "description": "状态码", "example": 200 }, "msg": { "type": "string", "description": "消息", "example": "success" }, "success": { "type": "boolean", "description": "是否成功", "example": true }, "data": { "description": "数据", "oneOf": [ { "type": "string" }, { "type": "object" }, { "type": "array" } ] }, "timestamp": { "type": "integer", "format": "int64", "description": "时间戳", "example": 1705896000000 } } }, "ErrorResponse": { "type": "object", "properties": { "code": { "type": "integer", "description": "错误状态码", "example": 500 }, "msg": { "type": "string", "description": "错误消息", "example": "解析分享链接失败: 具体错误信息" }, "success": { "type": "boolean", "description": "是否成功", "example": false }, "data": { "type": "object", "nullable": true }, "timestamp": { "type": "integer", "format": "int64", "description": "时间戳", "example": 1705896000000 } } } } } }