網友評分: 5分
迅雷云盤API助手是一款基于Python開發的資源下載工具,使用本工具可以作為 Agent 代理,直接使用 API 控制迅雷網盤離線下載資源,實現云播功能??梢栽诒竟ぞ叩幕A上開發自用云播軟件,喜歡這款軟件的小伙伴千萬不要錯過哦。
一、初始化環境
直接運行 迅雷云盤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 即打包編譯成功
標簽: 下載軟件