迅雷云盤(pán)API助手是一款基于Python開(kāi)發(fā)的資源下載工具，使用本工具可以作為 Agent 代理，直接使用 API 控制迅雷網(wǎng)盤(pán)離線下載資源，實(shí)現(xiàn)云播功能。可以在本工具的基礎(chǔ)上開(kāi)發(fā)自用云播軟件，喜歡這款軟件的小伙伴千萬(wàn)不要錯(cuò)過(guò)哦。

【使用教程】

　　一、初始化環(huán)境

　　直接運(yùn)行 迅雷云盤(pán)API.exe，系統(tǒng)會(huì)自動(dòng)檢查當(dāng)前程序目錄下是否存在 database.db 的數(shù)據(jù)庫(kù)文件，可以使用 Navicat 等支持 Sqlite3 數(shù)據(jù)庫(kù)的軟件打開(kāi)，無(wú)密碼。

　　如果不存在數(shù)據(jù)文件（也可以刪除數(shù)據(jù)文件來(lái)切換賬號(hào)），軟件會(huì)自行彈出內(nèi)置的chrome 瀏覽器，請(qǐng)?jiān)跒g覽器中輸入你的迅雷賬號(hào)和密碼并登錄。

　　登錄成功后，瀏覽器將自動(dòng)關(guān)閉，不再?gòu)棾?。軟件?huì)自動(dòng)保存你的 access_token 和 refresh_token ，此過(guò)程需要稍等片刻，時(shí)長(zhǎng)約 30 秒。

　　當(dāng)命令行中顯示 Server:http://0.0.0.0:8091 字樣時(shí)，表明軟件已經(jīng)初始化成功。你可以通過(guò) POST http://[你本地的ip]:8091/api/xxxx 進(jìn)行調(diào)用。

　　二 、部署調(diào)試網(wǎng)站

　　全局說(shuō)明： 軟件的所有接口地址均為 http://[server-ip]:8091/api/ + 函數(shù)方法名

　　請(qǐng)求API時(shí) ， 請(qǐng)求類(lèi)型均為 POST 請(qǐng)求 ， 其編碼方式為 application/json ， 需要在 header 中添加 content-type: application/json  請(qǐng)求頭

　　下面使用 寶塔面板的 Nginx 舉例創(chuàng)建一個(gè) 供調(diào)試的站點(diǎn)

　　1. 新建一個(gè)用來(lái)測(cè)試的網(wǎng)站

　　2. 新建反向代理，將網(wǎng)站的 /api/* 的請(qǐng)求 反代到 軟件接口 。 注意 Nginx 需要能和軟件所在的設(shè)備連通

　　3. 將文章最后的 下載地址中的 api.txt 文件下載下來(lái)上傳到網(wǎng)站中 ，然后重命名為 api.html

　　4. 訪問(wèn) http://網(wǎng)站域名/api.html

　　如上圖所示， 該網(wǎng)頁(yè)中已經(jīng)提供了軟件所有支持的 API 接口能力的 。 你可以復(fù)制左下角方框中輸出的 JSON 數(shù)據(jù)到 JSON 解析器中查看 ， 也可以打開(kāi) F12 瀏覽器開(kāi)發(fā)者模式查看

　　三、接口說(shuō)明

　　1. 列出文件夾中的所有文件

　　接口地址: /api/file_list/

　　請(qǐng)求參數(shù): parent_id 父目錄的文件id,為空表示根目錄

　　可在調(diào)試頁(yè)面中輸入 父目錄Id的值，然后點(diǎn)擊列出文件按鈕查看調(diào)用的請(qǐng)求。

　　特別的，響應(yīng)的data 中 kind 值表明了當(dāng)前文件對(duì)象的類(lèi)型 ， drive#file 表示文件 drive#folder 表示文件夾

　　2.新建文件夾

　　接口地址: /api/file_list/

　　請(qǐng)求參數(shù): parent_id 父目錄的文件id,為空表示根目錄

　　dirname 新文件夾的名稱

　　可在調(diào)試頁(yè)面中輸入父目錄id,文件夾名稱兩個(gè)文本框，然后點(diǎn)擊新建文件夾按鈕查看調(diào)用的請(qǐng)求。

　　3.刪除文件/文件夾

　　接口地址 /api/delete_file

　　請(qǐng)求參數(shù): file_id 父目錄的文件id 或需要?jiǎng)h除的文件的file_id

　　可在調(diào)試頁(yè)面中輸入文件/文件夾id字段，然后點(diǎn)擊刪除文件/文件夾按鈕

　　4. 新建離線任務(wù)

　　接口地址 /api/create_task

　　請(qǐng)求參數(shù): magnet 需要離線的資源的鏈接地址，支持 http/https,ftp,magnet 等類(lèi)型的資源

　　parent_id 必傳參數(shù)，存放的文件夾的父目錄的文件id

　　可在調(diào)試頁(yè)面中 離線連接字段，然后點(diǎn)新建離線任務(wù)按鈕

　　響應(yīng)的JSON 中 data 對(duì)象的內(nèi)容為新建離線任務(wù)的task_id 該參數(shù)在接口 查詢離線任務(wù)中用到

　　5.查詢離線任務(wù)

　　接口地址 /api/task_list

　　請(qǐng)求參數(shù)： task_id 離線的任務(wù)id ,可以為空，默認(rèn)查詢最近的 100 條離線任務(wù)數(shù)據(jù)

　　可在調(diào)試頁(yè)面中填寫(xiě)查詢離線任務(wù)字段，然后點(diǎn)擊查詢離線任務(wù)按鈕

　　特別的，響應(yīng)的file_id 字段為文件緩存結(jié)束后所在的文件夾/文件地址 ， 可以通過(guò)kind 字段判斷 是文件夾或文件

　　6. 查看文件詳情

　　接口地址 /api/file_info

　　請(qǐng)求參數(shù)： file_id 文件id

　　可在調(diào)試頁(yè)面中輸入文件/文件夾id字段，然后點(diǎn)擊查看文件詳情/播放按鈕

　　返回的JSON 數(shù)據(jù)包中 ， web_content_link 字段表示 普通用戶的限速下載地址 ， 通常情況下限速 1M/S

　　links.application/octet-stream 表示不限速的 VIP 下載地址

　　注意在調(diào)試DEMO中，僅會(huì)自動(dòng)播放文件類(lèi)型為 mp4/jpeg 格式的文件，且視頻文件需要手動(dòng)點(diǎn)擊播放按鈕才能播放

　　四、如何自定義打包

　　通常情況下只需要下載編譯好的產(chǎn)物即可，如果你的機(jī)器不支持編譯的產(chǎn)物，或者對(duì)編譯后的產(chǎn)物有安全擔(dān)憂的技術(shù)型用戶，可以參考下面的步驟手動(dòng)編譯打包

　　1.下載 源代碼壓縮包，解壓

　　2.執(zhí)行 pip install -r requirement.ini 安裝python 依賴

　　3. pip install peewee   // requirement.ini 里面漏寫(xiě)的包

　　4. pip install pyinstaller  // 安裝python 二進(jìn)制編譯的依賴

　　5. 在 源代碼目錄下新建 resoureces 文件夾，并將下載的資源文件解壓到這個(gè)目錄下面

　　6. 執(zhí)行 pyinstaller -F main.py -n 迅雷云盤(pán)API --add-data ".\\resources\\*;.\\resources" 編譯打包 ，大約 2 - 5 分鐘后 在 代碼目錄下的 dist 目錄下出現(xiàn) 迅雷云盤(pán)API.exe 即打包編譯成功