Deco BE85
Base URL: https://deco.msageha.net/api (TP-Link Deco BE85 ローカルAPI の FastAPI ラッパー)。このインスタンスへのリクエストには認証ヘッダー/クッキーは不要 — サーバーが保存された認証情報を使ってルーターにログインします。
重要なポイント
- ルーターへのログインは遅延実行されます:起動後またはアイドル後の最初の呼び出しでログインがトリガーされ、その呼び出しは遅くなります。期限切れのセッションは自動的に再ログインされ、リトライされます。
- リクエストはサーバー側のロック(単一ルーターセッション)によって直列化されます。エンドポイントは順番に呼び出してください。並列リクエストは行わないでください。
bandはband2_4/band5_1/band6、networkはhost/guestです。GET /wirelessはssid/passwordを Base64 エンコードして返します。書き込みエンドポイントは平文で受け付けます(サーバーがエンコードします)。- 書き込み操作の前にユーザーに確認してください:Wi-Fi の切り替え/設定変更はそのバンドのクライアントを一時的に切断します。
POST /reboot(confirm: trueが必要)はネットワーク全体を数分間ダウンさせます。POST /rawを読み取り以外のoperationで使うとルーターの任意の設定を変更できます。 - エラー:
401ルーター認証失敗、502ルーター側エラー(detail+error_code)、504ルーター到達不能、400/422リクエスト検証エラー。
コア操作
| タスク | エンドポイント |
|---|---|
| 概要(WAN/CPU/メモリ/ノード & クライアント数) | GET /dashboard |
| Deco ユニット(メッシュノード) | GET /devices |
| 接続中のクライアント | GET /clients?online_only=true |
| ブロックされたクライアント | GET /clients/blocked |
| Wi-Fi 設定(全バンド、ホスト/ゲスト) | GET /wireless |
| バンドごとの Wi-Fi ON/OFF | POST /wireless |
| SSID/パスワード/チャンネル等の変更 | POST /wireless/config |
| WAN / インターネット / LAN / IPv6 状態 | GET /network/wan、GET /network/internet、GET /network/lan、GET /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 を参照してください。