mirror of
https://github.com/qaiu/netdisk-fast-download.git
synced 2025-12-16 12:23:03 +00:00
1382 lines
37 KiB
JSON
1382 lines
37 KiB
JSON
{
|
||
"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
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|