最后更新:2025-10-10
高级转存接口:迅雷网盘分享链接的高级转存处理工具,集成了文件转存、分享、广告过滤、广告添加、去重处理等多种功能。适用于需要批量处理和自动化管理的场景。
智能去重处理:5种去重方式,灵活处理重复文件
广告文件过滤:异步过滤广告,支持全局/Cookie级别规则
广告文件添加:支持添加广告文件到转存目录
文件夹创建:单文件支持自动创建文件夹
内容净化:过滤掉不需要的广告和推广文件
推广管理:在转存的同时添加自己的推广文件
批量处理:大量文件的智能过滤和处理
内容分发:为转存的内容添加推广信息
使用网盘Cookie提取工具获取
下载并打开:网盘Cookie提取工具
按照工具提示登录迅雷网盘
自动获取Cookie并复制
在用户中心的Cookie管理页面中,将复制的Cookie粘贴到添加Cookie输入框,保存即可
注意:迅雷网盘Cookie只能走软件抓取(若软件打不开请联系站长协助),有效期理论永久,Cookie托管到平台以后在本地浏览器上尽量不要登录了,可以使用APP或者软件管理,过期需要重新获取。
接口地址:https://api.ccnccn.cn/xunlei_senior?
请求方式:GET
返回格式:JSON
调用频率:1/1S
接口状态:正常运行中
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| token | 是 | string | 用户调用接口token,在用户中心-个人信息获取 |
| cookie | 是 | int | 值为cookie管理中的ID,请注意对应关系,填写迅雷的cookie ID |
| url | 是 | string | 迅雷网盘分享链接,例如:https://pan.xunlei.com/s/xxxxx&pwd=xxxx |
| fid | 否 | string | 保存到指定目录的ID,Cookie管理-刷新目录内获取,默认保存到根目录“/” |
| priv | 否 | boolean | 是否允许转存特权文件(24小时加速下载的文件,没有收益),true或false,默认true |
| share | 否 | boolean | 是否创建分享链接,true或false,默认false |
| time | 否 | string | 分享有效期,-1(永久)或1-7(天数),默认-1,仅在share=true时有效 |
| repeat | 否 | int | 去重方式,1-5之间的整数,默认1。详见下方说明 |
| ad_scope | 否 | string | 广告过滤范围,all/cookie/global。详见下方说明 |
| ad_match | 否 | string | 广告匹配模式,fuzzy/exact。详见下方说明 |
| add_ad | 否 | boolean | 是否添加广告文件,true或false,默认false |
| create_folder | 否 | boolean | 单文件是否创建文件夹,true或false,默认false |
| 去重方式 | 值 | 说明 |
|---|---|---|
| 方式1 | 1 | 删除原文件后再转存(默认) |
| 方式2 | 2 | 修改原文件名后再转存 |
| 方式3 | 3 | 将原文件移动到待删除目录后再转存 |
| 方式4 | 4 | 忽略删除原文件的错误,继续转存 |
| 方式5 | 5 | 纯转存模式,不检测重复文件,不记录到数据库 |
广告过滤功能"默认开启"且使用"异步处理模式"以确保响应速度。
| 参数 | 选项 | 说明 |
|---|---|---|
| ad_scope | all | 使用全局+Cookie级别的广告规则(默认) |
| ad_scope | global | 仅使用全局广告规则 |
| ad_scope | cookie | 仅使用Cookie级别的广告规则 |
| ad_match | fuzzy | 模糊匹配(包含关键词即匹配,默认) |
| ad_match | exact | 精确匹配(文件名完全相同才匹配) |
| 参数名 | 类型 | 说明 |
|---|---|---|
| success | boolean | 请求是否成功 |
| message | string | 提示信息 |
| data | object | 返回数据 |
| data.file_name | string | 文件名称 |
| data.fs_id | string | 文件ID(仅转存时返回) |
| data.share_url | string | 分享链接(仅share=true时返回) |
| data.pwd | string | 提取码(仅share=true时返回) |
| data.time | string | 分享有效期(仅share=true时返回) |
| data.ad_filter_mode | string | 广告过滤模式,固定为async |
| data.ad_filter_task_id | string | 广告过滤任务ID |
| data.ad_filter_details | object | 广告过滤详细信息,包含规则数量和规则示例 |
| data.ad_files_info | object | 添加广告文件的详细信息 |
| data.skipped_file | string | 跳过的重复文件名 |
基础转存(删除重复文件)
https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX转存并分享7天
https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&share=true&time=7转存并分享7天(过滤广告,模糊匹配)
https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&share=true&time=7&ad_match=fuzzy仅使用全局广告规则过滤 + 添加广告文件
https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&add_ad=true&ad_scope=global纯转存模式(不记录历史)
https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&repeat=5单文件创建文件夹 + 重命名去重
https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&create_folder=true&repeat=2仅转存成功
{
"success": true,
"message": "转存成功",
"data": {
"file_name": "测试文件合集",
"fs_id": "VOS9VSWs-BcLGG6oEI73hJVLA1"
}
}
转存并分享 + 广告过滤成功
{
"success": true,
"message": "转存并分享成功,广告文件过滤任务已提交(异步处理中)",
"data": {
"file_name": "测试文件合集",
"share_url": "https://pan.xunlei.com/s/xxxxxx",
"pwd": "3eyq",
"time": "7",
"ad_filter_mode": "async",
"ad_filter_task_id": "task_12345",
"ad_filter_details": {
"ad_rules_count": 15,
"ad_rules": ["广告", "推广", "QQ群", "微信", "链接"]
}
}
}
转存 + 广告过滤 + 添加广告文件成功
{
"success": true,
"message": "转存成功,广告文件过滤任务已提交(异步处理中),成功添加2个广告文件,失败0个",
"data": {
"file_name": "测试文件合集",
"fs_id": "VOS9VSWs-BcLGG6oEI73hJVLA1",
"ad_filter_mode": "async",
"ad_filter_task_id": "task_12345",
"ad_filter_details": {
"ad_rules_count": 20,
"ad_rules": ["广告.txt", "推广.url", "QQ群.txt", "微信.txt", "链接.txt"]
},
"ad_files_info": {
"copied_ad_files": 2,
"failed_ad_files": 0,
"input_ad_file_ids": ["VO1qjfCD8MQZ19WbsUPMwpQhA1", "VO2rjgDE9NRa20XctVQNxqRiB2"]
}
}
}
调用接口报错
{
"success": false,
"message": "错误信息",
"data": null
}
| 错误信息 | 说明 | 解决方案 |
|---|---|---|
| 参数错误: 缺少token参数 | 未提供用户token | 在用户中心获取token |
| 参数错误: 缺少cookie参数,请指定要使用的cookie ID | 未提供Cookie ID | 检查cookie参数是否正确传递 |
| 参数错误: 缺少url参数 | 未提供分享链接 | 检查url参数是否正确传递 |
| 参数错误: priv参数只能是true或false | priv参数值错误 | 修正参数值为true或false |
| 参数错误: share参数只能是true或false | share参数值错误 | 修正参数值为true或false |
| 参数错误: filter_ad参数只能是true或false | filter_ad参数值错误 | 修正参数值为true或false |
| 参数错误: ad_scope参数只能是all、cookie或global | ad_scope参数值错误 | 使用正确的广告过滤范围 |
| 参数错误: ad_match参数只能是fuzzy或exact | ad_match参数值错误 | 使用正确的广告匹配模式 |
| 分享时间格式不正确,只能是-1(永久)或1-7(天)中的一个 | 分享时间参数错误 | 设置正确的分享有效期 |
| 去重方式不正确,只能是1\2\3\4\5中的一个 | repeat参数值错误 | 使用正确的去重方式 |
| ID为X的Cookie类型错误,应为迅雷网盘(xunlei),实际为Y | Cookie类型不匹配 | 确保使用的是迅雷网盘Cookie |
| ID为X的迅雷网盘Cookie不存在,请到Cookie管理检查 | Cookie不存在 | 在Cookie管理中添加对应的Cookie |
| ID为X的迅雷网盘Cookie已失效,请到Cookie管理重新设置 | Cookie已失效 | 重新获取并更新Cookie |
| 无效的分享链接格式,请提供正确的迅雷网盘分享链接 | 分享链接格式错误 | 检查分享链接是否正确 |
| 未设置要添加的广告文件ID,请先在Cookie管理中设置广告文件ID(用于向文件夹添加广告文件) | 广告文件ID未设置 | 在Cookie管理中设置广告文件ID |
| 未设置广告文件过滤规则,请先在Cookie管理中设置广告文件规则(用于识别和过滤广告文件) | 广告过滤规则未设置 | 在Cookie管理中设置广告过滤规则 |
| 分享内容为单文件或多个独立文件不支持添加广告文件,只有文件夹才支持 | 分享内容不支持添加广告文件 | 使用create_folder=true创建文件夹,或转存包含文件夹的分享 |
| 未设置待删除目录,请先在Cookie管理中设置 | 待删除目录未设置 | 在Cookie管理中设置待删除目录(去重方式3需要) |
| Token无效或账号已被封禁 | token错误或账号状态异常 | 检查token是否有效,或联系客服 |
| 调用次数已用完或已过期 | 超出调用限制或已过期 | 联系站长加次数和时间 |
| 转存失败: XXX | 转存过程出错 | 检查参数重试 |
| 分享失败: XXX | 分享过程出错 | 检查参数重试 |
| 去重失败: XXX | 去重处理失败 | 检查去重设置或重试 |
使用过滤广告功能,需要在Cookie管理中预先设置过滤规则。
使用添加广告功能,需要先在Cookie管理中设置广告文件ID。
请确保Cookie有效,检测状态正常,否则可能导致调用失败。
异步过滤操作在后台进行,接口不会立即返回过滤结果。
过滤广告文件不可恢复,请谨慎设置过滤规则避免删掉需要的文件。
使用浏览器调用时,请勿给参数里带#(浏览器会忽略#后面的所有参数导致调用失败)
每个账号有调用次数和有效期限制,可联系站长购买套餐。
2025-11-08:完善API文档,增强用户体验
2025-11-07:移除同步过滤模式,统一使用异步模式,确保接口时效性
2025-10-08:优化处理逻辑,加快响应速度
2025-09-28:接口上线,使用分散架构设计