夸克网盘PHP API完整文档

📖 概述

本文档介绍了7个独立的夸克网盘PHP API接口，每个API都可以独立部署和使用。这些API覆盖了夸克网盘的核心功能，包括账号验证、文件管理、转存、分享等操作。

🎯 快速开始

将所需的PHP文件部署到Web服务器
确保PHP版本 >= 7.0，并启用cURL扩展
获取夸克网盘的Cookie（登录后从浏览器开发者工具获取）
使用POST方法调用相应的API接口
所有API均返回JSON格式响应

API列表总览

1. Cookie验证与用户信息API

quark_api_verify.php

验证Cookie有效性并获取用户昵称、容量信息

2. 文件列表获取API

quark_api_files.php

获取指定目录下的文件和文件夹列表

3. 转存文件API

quark_api_transfer.php

将分享链接转存到指定目录

4. 创建分享API

quark_api_share.php

为文件或文件夹创建分享链接

5. 转存并分享一体化API

quark_api_transfer_share.php

转存后自动创建分享链接（一步到位）

6. 创建目录API

quark_api_create_folder.php

在指定位置创建新目录

7. 删除文件/目录API

quark_api_delete.php

删除指定的文件或目录到回收站

🔐 API 1: Cookie验证与用户信息

POST quark_api_verify.php

功能描述

验证夸克网盘Cookie是否有效，并获取用户的昵称、已用容量、总容量等信息。

核心特性：

Cookie有效性验证
获取用户昵称
获取存储空间使用情况
人性化容量格式化显示

请求参数

参数名	类型	必填	说明
cookie	string	是	夸克网盘Cookie字符串

成功响应示例

JSON

{
    "success": true,
    "message": "Cookie有效",
    "data": {
        "nickname": "张三",
        "used_capacity": "15.23 GB",
        "total_capacity": "100.00 GB",
        "used_bytes": 16352641024,
        "total_bytes": 107374182400,
        "usage_percentage": "15.23%"
    }
}

📁 API 2: 文件列表获取

POST quark_api_files.php

功能描述

获取指定目录下的所有文件和文件夹列表，包括文件名、ID、大小、修改时间等详细信息。

请求参数

参数名	类型	必填	说明
cookie	string	是	夸克网盘Cookie字符串
parent_fid	string	否	父目录ID，默认为"0"（根目录）

成功响应示例

JSON

{
    "success": true,
    "message": "获取文件列表成功",
    "data": {
        "folders": [{"fid": "123", "name": "我的文档", "size_formatted": "0 B"}],
        "files": [{"fid": "456", "name": "报告.pdf", "size_formatted": "1.95 MB"}],
        "total_count": 2
    }
}

📥 API 3: 转存文件

POST quark_api_transfer.php

功能描述

将夸克网盘分享链接转存到自己的账号指定目录中。

请求参数

参数名	类型	必填	说明
cookie	string	是	夸克网盘Cookie
share_url	string	是	分享链接
folder_name	string	否	目标目录名称
folder_id	string	否	目标目录ID（优先）

💡 注意：folder_name 和 folder_id 必须提供其中一个。

🔗 API 4: 创建分享

POST quark_api_share.php

功能描述

为指定的文件或文件夹创建分享链接，支持设置有效期。

请求参数

参数名	类型	必填	说明
cookie	string	是	夸克网盘Cookie
file_name	string	否	文件/文件夹名称
fid	string	否	文件/文件夹ID（优先）
validity	string	否	有效期：1=永久, 2=1天, 3=7天, 4=30天

⚡ API 5: 转存并分享一体化

POST quark_api_transfer_share.php

功能描述

转存分享链接后自动创建新的分享链接，一步完成转存和分享操作。

核心特性：

一次请求完成转存和分享
自动等待转存完成（3-7秒智能延时）
支持自定义分享标题
返回完整的转存和分享信息

请求参数

参数名	类型	必填	说明
cookie	string	是	夸克网盘Cookie
share_url	string	是	要转存的分享链接
folder_name	string	否	目标目录名称
folder_id	string	否	目标目录ID
validity	string	否	分享有效期
share_title	string	否	自定义分享标题

📂 API 6: 创建目录

POST quark_api_create_folder.php

功能描述

在指定的父目录下创建新目录，如果目录已存在则返回已存在目录的信息。

核心特性：

请求参数

参数名	类型	必填	说明
cookie	string	是	夸克网盘Cookie
parent_fid	string	否	父目录ID，默认"0"（根目录）
folder_name	string	是	新目录名称

成功响应示例

JSON

{
    "success": true,
    "message": "目录创建成功",
    "data": {
        "fid": "123456789",
        "name": "我的文档",
        "parent_fid": "0",
        "existed": false
    }
}

🗑️ API 7: 删除文件/目录

POST quark_api_delete.php

功能描述

删除指定的文件或目录到回收站（可恢复）。支持通过文件名或FID删除。

核心特性：

支持通过文件名或FID删除
删除到回收站（可恢复）
返回被删除对象的详细信息
支持删除文件和目录

请求参数

参数名	类型	必填	说明
cookie	string	是	夸克网盘Cookie
parent_fid	string	否	父目录ID
file_name	string	否	文件/目录名称
fid	string	否	文件/目录ID（优先）

⚠️ 安全提示：文件被删除到回收站，可以在夸克网盘的回收站中恢复。

💻 使用示例

JavaScript调用示例

JavaScript

// 调用Cookie验证API
fetch('http://localhost/quark_api_verify.php', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({cookie: 'your_cookie_here'})
})
.then(res => res.json())
.then(data => console.log(data));

// 调用转存并分享API
fetch('http://localhost/quark_api_transfer_share.php', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({
        cookie: 'your_cookie_here',
        share_url: 'https://pan.quark.cn/s/xxxxx',
        folder_name: '我的收藏',
        validity: '3'
    })
})
.then(res => res.json())
.then(data => console.log(data));

PHP调用示例

PHP

<?php
$url = 'http://localhost/quark_api_create_folder.php';
$data = [
    'cookie' => 'your_cookie_here',
    'folder_name' => '新建目录'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
?>

Python调用示例

Python

import requests

url = 'http://localhost/quark_api_files.php'
data = {
    'cookie': 'your_cookie_here',
    'parent_fid': '0'
}
response = requests.post(url, json=data)
print(response.json())

cURL命令示例

Shell

curl -X POST http://localhost/quark_api_delete.php \
  -H "Content-Type: application/json" \
  -d '{"cookie":"your_cookie_here","file_name":"要删除的文件.txt"}'