Deco BE85
Base URL: https://deco.msageha.net/api(為 TP-Link Deco BE85 本地 API 建立的 FastAPI 包裝器)。對這個實例的請求不需要任何認證標頭/Cookie——伺服器會以儲存的憑證自行登入路由器。
關鍵資訊
- 登入路由器是懶載入的:啟動或閒置後的第一個請求會觸發登入,速度較慢。過期的連線會自動重新登入並重試。
- 請求會透過伺服端鎖(單一路由器連線)序列化。請依序呼叫端點;不要分散發出並行請求。
band為band2_4/band5_1/band6;network為host或guest。GET /wireless傳回 base64 編碼的ssid/password;寫入端點接受純文字(伺服器會自行編碼)。- 在任何寫入操作前需先徵得使用者同意:Wi-Fi 開關/設定變更會短暫中斷該頻段的客戶端連線,
POST /reboot(需要confirm: true)會使整個網路下線數分鐘,而POST /raw搭配非唯讀的operation可以更改任意路由器設定。 - 錯誤:
401路由器身分驗證失敗,502路由器端錯誤(附有detail+error_code),504路由器無法連線,400/422請求驗證失敗。
核心操作
| 任務 | 端點 |
|---|---|
| 總覽(WAN/CPU/記憶體/節點及客戶端數量) | GET /dashboard |
| Deco 單元(Mesh 節點) | GET /devices |
| 已連線客戶端 | GET /clients?online_only=true |
| 被封鎖客戶端 | GET /clients/blocked |
| Wi-Fi 設定(所有頻段,主/來賓網路) | GET /wireless |
| Wi-Fi 開/關(依頻段) | POST /wireless |
| 變更 SSID/密碼/頻道等 | POST /wireless/config |
| WAN / 網際網路 / LAN / IPv6 狀態 | GET /network/wan, /network/internet, /network/lan, /network/ipv6 |
| CPU / 記憶體使用率 | GET /network/performance |
| 重啟 Deco 單元(具破壞性) | POST /reboot |
| 其他任何 Deco 端點(逸脫處理) | POST /raw |
| 伺服器健康狀態 / 明確登入 | GET /health, POST /login, POST /logout |
完整的請求/回應結構描述與可直接執行的 curl 範例,請參閱 references/api-reference.md 與 references/commands.md。