最后更新：2025-11-30
高级转存接口：夸克网盘分享链接的高级转存处理工具，集成了文件转存、分享、广告过滤、广告添加、去重处理等多种功能。适用于需要批量处理和自动化管理的场景。
智能去重处理：5种去重方式，灵活处理重复文件
广告文件过滤：纯异步过滤广告文件，支持全局/Cookie级别规则
文件名过滤：纯异步过滤文件名中的广告文字
广告文件添加：支持添加广告文件到转存目录
文件夹创建：单文件支持自动创建文件夹
内容净化：过滤掉不需要的广告和推广文件
推广管理：在转存的同时添加自己的推广文件
批量处理：大量文件的智能过滤和处理
内容分发：为转存的内容添加推广信息
接口地址：https://api.ccnccn.cn/quark_senior?
请求方式：GET
返回格式：JSON
调用频率：1/1S
接口状态：已上线
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| token | 是 | string | 用户调用接口token，在用户中心-个人信息获取 |
| cookie | 是 | int | 值为cookie管理中的ID，请注意对应关系，填写夸克的cookie ID |
| url | 是 | string | 夸克网盘分享链接，例如：https://pan.quark.cn/s/abc123 |
| fid | 否 | string | 保存路径的文件夹ID，0表示根目录，默认为0 |
| repeat | 否 | int | 去重方式，1-5之间的整数，默认1。详见下方说明 |
| create_folder | 否 | boolean | 单文件是否创建文件夹，true或false，默认false |
| filter_ad | 否 | boolean | 是否过滤广告文件，true或false，默认false |
| filter_name | 否 | boolean | 是否过滤文件名中的广告文字，true或false，默认false |
| ad_scope | 否 | string | 广告规则范围，all/cookie/global。详见下方说明 |
| ad_match | 否 | string | 广告匹配模式（仅用于filter_ad），fuzzy/exact。详见下方说明 |
| add_ad | 否 | boolean | 是否添加广告文件，true或false，默认false |
| share | 否 | string | 是否需要分享，true或false，默认false |
| url_type | 否 | int | 分享类型，1=公开分享，2=密码分享，默认1，仅在share=true时有效 |
| code | 否 | string | 分享提取码（4位字母数字组合），默认随机生成，仅在url_type=2时有效 |
| time | 否 | string | 分享有效期，1=永久，2=1天，3=7天，4=30天，默认1，仅在share=true时有效 |
| 去重方式 | 值 | 说明 |
|---|---|---|
| 方式1 | 1 | 删除原文件后再转存（默认） |
| 方式2 | 2 | 修改原文件名后再转存 |
| 方式3 | 3 | 将原文件移动到待删除目录后再转存 |
| 方式4 | 4 | 忽略删除原文件的错误，继续转存 |
| 方式5 | 5 | 纯转存模式，不检测重复文件，不记录到数据库 |
过滤模式：所有过滤操作均采用纯异步处理，确保API快速响应，不阻塞用户请求。
广告规则范围（ad_scope）
| 选项 | 说明 |
|---|---|
| all | 使用全局+Cookie级别的广告规则（默认） |
| global | 仅使用全局广告规则 |
| cookie | 仅使用Cookie级别的广告规则 |
广告匹配模式（ad_match）
| 选项 | 说明 | 适用范围 |
|---|---|---|
| fuzzy | 模糊匹配（包含关键词即匹配，默认） | 仅用于filter_ad（广告文件过滤） |
| exact | 精确匹配（文件名完全相同才匹配） | 仅用于filter_ad（广告文件过滤） |
文件名过滤说明
filter_name 会移除文件名中所有匹配的广告规则片段（不受ad_match影响，始终使用模糊匹配）。
示例：
游戏-资源网www.bd.com资源网, www.bd.com, -游戏| 参数名 | 类型 | 说明 |
|---|---|---|
| success | boolean | 请求是否成功 |
| message | string | 提示信息（包含过滤和添加详情） |
| data | object | 返回数据 |
| data.file_name | string | 转存后的实际文件名 |
| data.fs_id | string | 文件ID（仅转存时返回） |
| data.ad_file_rules_count | int | 广告文件过滤规则数量（filter_ad=true时返回） |
| data.ad_file_task_id | string | 广告文件过滤任务ID（filter_ad=true时返回） |
| data.ad_file_error | string | 广告文件过滤任务创建失败信息（如有） |
| data.ad_name_rules_count | int | 文件名过滤规则数量（filter_name=true时返回） |
| data.ad_name_task_id | string | 文件名过滤任务ID（filter_name=true时返回） |
| data.ad_add_count | int | 添加的广告文件数量（add_ad=true时返回） |
| data.share_url | string | 分享链接（仅share=true时返回） |
| data.pwd | string | 提取码（仅密码分享时返回） |
| data.time | int | 有效期类型（仅share=true时返回） |
基础转存并过滤广告文件
https://api.ccnccn.cn/quark_senior?token=your_token&cookie=1&url=https://pan.quark.cn/s/abc123&filter_ad=true过滤文件名中的广告文字
https://api.ccnccn.cn/quark_senior?token=your_token&cookie=1&url=https://pan.quark.cn/s/abc123&filter_name=true同时过滤广告文件和文件名
https://api.ccnccn.cn/quark_senior?token=your_token&cookie=1&url=https://pan.quark.cn/s/abc123&filter_ad=true&filter_name=true过滤、添加推广并分享
https://api.ccnccn.cn/quark_senior?token=your_token&cookie=1&url=https://pan.quark.cn/s/abc123&filter_ad=true&filter_name=true&add_ad=true&share=true&url_type=2&time=3仅转存 + 广告文件和文件名过滤
{
"success": true,
"message": "转存成功，广告文件和文件名过滤任务已提交（异步处理中）",
"data": {
"file_name": "测试文件.mp4",
"fs_id": "folder_id_12346",
"ad_file_rules_count": 15,
"ad_file_task_id": "task_67890",
"ad_name_rules_count": 8,
"ad_name_task_id": "task_67891"
}
}
转存并分享 + 广告文件和文件名过滤
{
"success": true,
"message": "转存并分享成功，广告文件和文件名过滤任务已提交（异步处理中）",
"data": {
"file_name": "测试文件.mp4",
"share_url": "https://pan.quark.cn/s/abc123?pwd=xgju",
"pwd": "xgju",
"time": 1,
"ad_file_rules_count": 4,
"ad_file_task_id": "6740",
"ad_name_rules_count": 5,
"ad_name_task_id": "6739"
}
}
转存并分享 + 广告文件和文件名过滤 + 添加广告文件
{
"success": true,
"message": "转存并分享成功，广告文件和文件名过滤任务已提交（异步处理中），已添加2个广告文件",
"data": {
"file_name": "测试文件.mp4",
"share_url": "https://pan.quark.cn/s/xyz789",
"pwd": "abc1",
"time": 3,
"ad_file_rules_count": 10,
"ad_file_task_id": "task_67892",
"ad_name_rules_count": 5,
"ad_name_task_id": "task_67893",
"ad_add_count": 2
}
}
| 错误信息 | 说明 | 解决方案 |
|---|---|---|
| 缺少token参数 | 未提供用户token | 在用户中心获取token |
| 参数错误: 缺少cookie参数 | 未提供Cookie ID | 指定要使用的Cookie ID |
| 参数错误: 缺少url参数 | 未提供分享链接 | 检查url参数是否正确传递 |
| 参数错误: ad_scope参数只能是all、cookie或global | 过滤范围参数错误 | 使用正确的过滤范围参数 |
| 参数错误: ad_match参数只能是fuzzy或exact | 匹配模式参数错误 | 使用正确的匹配模式参数 |
| 未设置添加广告文件ID或ID列表为空 | 未设置推广文件 | 在Cookie管理中设置广告文件ID |
| Token无效或账号已被封禁 | token错误或账号状态异常 | 检查token是否有效，或联系站长 |
| 调用次数已用完或已过期 | 超出调用限制或已过期 | 联系站长加次数和时间 |
| ID为X的夸克网盘Cookie不存在 | Cookie不存在或已删除 | 需要在Cookie管理中添加夸克Cookie |
| ID为X的夸克网盘Cookie已失效 | Cookie已失效 | 需要在Cookie管理中重新设置Cookie |
使用过滤功能（filter_ad或filter_name），需要在Cookie管理中预先设置过滤规则。
使用添加广告功能，需要先在Cookie管理中设置广告文件ID。
请确保Cookie有效，检测状态正常，否则可能导致调用失败。
所有过滤操作均为纯异步处理，接口立即返回任务ID，不阻塞响应。
异步任务在后台处理，可通过任务ID查询进度和结果。
过滤操作不可恢复，请谨慎设置过滤规则避免删掉需要的文件。
文件名过滤每3秒处理一个文件，避免API限流。
使用浏览器调用时，请勿给参数里带#（浏览器会忽略#后面的所有参数导致调用失败）
每个账号有调用次数和有效期限制，可联系站长购买套餐。
2025-11-30：重大更新
filter_name 参数，支持过滤文件名中的广告文字ad_file_（广告文件）、ad_name_（文件名）、ad_add_count（添加数量）ad_filter_mode 和 ad_name_mode 字段（固定为异步）2025-11-08：完善API文档，增强用户体验
2025-11-07：移除同步过滤模式，统一使用异步模式，确保接口时效性
2025-10-08：优化处理逻辑，加快响应速度
2025-09-28：接口上线，使用分散架构设计