Deco BE85
Base URL : https://deco.msageha.net/api (wrapper FastAPI autour de l'API locale du TP-Link Deco BE85). Les requêtes vers cette instance ne nécessitent aucun en-tête/cookie d'authentification — le serveur se connecte lui-même au routeur avec des identifiants stockés.
Points clés
- La connexion au routeur est paresseuse : le premier appel après le démarrage ou une période d'inactivité déclenche la connexion et est plus lent. Les sessions expirées sont reconnectées et réessayées automatiquement.
- Les requêtes sont sérialisées derrière un verrou côté serveur (session unique du routeur). Appelez les points d'accès de manière séquentielle ; n'envoyez pas de requêtes parallèles.
bandcorrespond àband2_4/band5_1/band6;networkcorrespond àhost/guest.GET /wirelessrenvoiessid/passwordencodés en base64 ; les points d'accès d'écriture les acceptent en texte brut (le serveur les encode).- Confirmez avec l'utilisateur avant toute écriture : les bascules/configurations Wi-Fi déconnectent brièvement les clients sur cette bande,
POST /reboot(nécessiteconfirm: true) met tout le réseau hors service pendant plusieurs minutes, etPOST /rawavec uneoperationautre que lecture peut modifier des paramètres arbitraires du routeur. - Erreurs :
401échec d'authentification du routeur,502erreur côté routeur (detail+error_code),504routeur injoignable,400/422validation de la requête.
Opérations principales
| Tâche | Point d'accès |
|---|---|
| Aperçu (WAN/CPU/mémoire/nœuds et clients) | GET /dashboard |
| Unités Deco (nœuds maillés) | GET /devices |
| Clients connectés | GET /clients?online_only=true |
| Clients bloqués | GET /clients/blocked |
| Paramètres Wi-Fi (toutes bandes, hôte/invité) | GET /wireless |
| Wi-Fi ON/OFF par bande | POST /wireless |
| Changer SSID/mot de passe/canal etc. | POST /wireless/config |
| Statut WAN / internet / LAN / IPv6 | GET /network/wan, /network/internet, /network/lan, /network/ipv6 |
| Utilisation CPU / mémoire | GET /network/performance |
| Redémarrer les unités Deco (destructeur) | POST /reboot |
| Tout autre point d'accès Deco (échappatoire) | POST /raw |
| Santé du serveur / connexion explicite | GET /health, POST /login, POST /logout |
Schémas de requête/réponse complets et exemples curl prêts à l'emploi : voir references/api-reference.md et references/commands.md.