迅雷云盘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 即打包编译成功