迅雷云盘API助手是一款基于Python开发的资源下载工具,可以作为 Agent 代理,直接使用 API 控制迅雷网盘离线下载资源,实现云播功能。可以在本工具的基础上开发自用云播软件
使用教程
一、初始化环境
直接运行 迅雷云盘API.exe,系统会自动检查当前程序目录下是否存在 database.db 的数据库文件,可以使用 Navicat 等支持 Sqlite3 数据库的软件打开,无密码。
如果不存在数据文件(也可以删除数据文件来切换账号),软件会自行弹出内置的chrome 浏览器,请在浏览器中输入你的迅雷账号和密码并登录。
登录成功后,浏览器将自动关闭,不再弹出。软件会自动保存你的 access_token 和 refresh_token ,此过程需要稍等片刻,时长约 30 秒。
当命令行中显示 Server:http://0.0.0.0:8091 字样时,表明软件已经初始化成功。你可以通过 POST http://[你本地的ip]:8091/api/xxxx 进行调用。
二 、部署调试网站
全局说明: 软件的所有接口地址均为 http://[server-ip]:8091/api/ + 函数方法名
请求API时 , 请求类型均为 POST 请求 , 其编码方式为 application/json , 需要在 header 中添加 content-type: application/json 请求头
下面使用 宝塔面板的 Nginx 举例创建一个 供调试的站点
1. 新建一个用来测试的网站
2. 新建反向代理,将网站的 /api/* 的请求 反代到 软件接口 。 注意 Nginx 需要能和软件所在的设备连通
3. 将文章最后的 下载地址中的 api.txt 文件下载下来上传到网站中 ,然后重命名为 api.html
4. 访问 http://网站域名/api.html
如上图所示, 该网页中已经提供了软件所有支持的 API 接口能力的 。 你可以复制左下角方框中输出的 JSON 数据到 JSON 解析器中查看 , 也可以打开 F12 浏览器开发者模式查看
三、接口说明
1. 列出文件夹中的所有文件
接口地址: /api/file_list/
请求参数: parent_id 父目录的文件id,为空表示根目录
可在调试页面中输入 父目录Id的值,然后点击列出文件按钮查看调用的请求。
特别的,响应的data 中 kind 值表明了当前文件对象的类型 , drive#file 表示文件 drive#folder 表示文件夹
2.新建文件夹
接口地址: /api/file_list/
请求参数: parent_id 父目录的文件id,为空表示根目录
dirname 新文件夹的名称
可在调试页面中输入父目录id,文件夹名称两个文本框,然后点击新建文件夹按钮查看调用的请求。
3.删除文件/文件夹
接口地址 /api/delete_file
请求参数: file_id 父目录的文件id 或需要删除的文件的file_id
可在调试页面中输入文件/文件夹id字段,然后点击删除文件/文件夹按钮
4. 新建离线任务
接口地址 /api/create_task
请求参数: magnet 需要离线的资源的链接地址,支持 http/https,ftp,magnet 等类型的资源
parent_id 必传参数,存放的文件夹的父目录的文件id
可在调试页面中 离线连接字段,然后点新建离线任务按钮
响应的JSON 中 data 对象的内容为新建离线任务的task_id 该参数在接口 查询离线任务中用到
5.查询离线任务
接口地址 /api/task_list
请求参数: task_id 离线的任务id ,可以为空,默认查询最近的 100 条离线任务数据
可在调试页面中填写查询离线任务字段,然后点击查询离线任务按钮
特别的,响应的file_id 字段为文件缓存结束后所在的文件夹/文件地址 , 可以通过kind 字段判断 是文件夹或文件
6. 查看文件详情
接口地址 /api/file_info
请求参数: file_id 文件id
可在调试页面中输入文件/文件夹id字段,然后点击查看文件详情/播放按钮
返回的JSON 数据包中 , web_content_link 字段表示 普通用户的限速下载地址 , 通常情况下限速 1M/S
links.application/octet-stream 表示不限速的 VIP 下载地址
注意在调试DEMO中,仅会自动播放文件类型为 mp4/jpeg 格式的文件,且视频文件需要手动点击播放按钮才能播放
四、如何自定义打包
通常情况下只需要下载编译好的产物即可,如果你的机器不支持编译的产物,或者对编译后的产物有安全担忧的技术型用户,可以参考下面的步骤手动编译打包
1.下载 源代码压缩包,解压
2.执行 pip install -r requirement.ini 安装python 依赖
3. pip install peewee // requirement.ini 里面漏写的包
4. pip install pyinstaller // 安装python 二进制编译的依赖
5. 在 源代码目录下新建 resoureces 文件夹,并将下载的资源文件解压到这个目录下面
6. 执行 pyinstaller -F main.py -n 迅雷云盘API --add-data ".\\resources\\*;.\\resources" 编译打包 ,大约 2 - 5 分钟后 在 代码目录下的 dist 目录下出现 迅雷云盘API.exe 即打包编译成功
∨ 展开