Deco BE85
URL Base: https://deco.msageha.net/api (wrapper FastAPI alrededor de la API local del TP-Link Deco BE85). Las solicitudes a esta instancia no necesitan encabezados de autenticación ni cookies — el servidor inicia sesión en el router automáticamente con credenciales almacenadas.
Datos clave
- El inicio de sesión en el router es perezoso: la primera llamada después del arranque/inactividad lo activa y es más lenta. Las sesiones expiradas se reinician y reintentan automáticamente.
- Las solicitudes se serializan tras un bloqueo del lado del servidor (sesión única del router). Llama a los endpoints secuencialmente; no dispares solicitudes en paralelo.
bandpuede serband2_4/band5_1/band6;networkpuede serhost/guest.GET /wirelessdevuelvessid/passwordcodificados en base64; los endpoints de escritura los aceptan en texto plano (el servidor los codifica).- Confirma con el usuario antes de cualquier escritura: los cambios de Wi-Fi/alternar configuraciones desconectan brevemente los clientes en esa banda,
POST /reboot(requiereconfirm: true) deja toda la red fuera de servicio durante minutos, yPOST /rawcon unaoperationno de lectura puede cambiar ajustes arbitrarios del router. - Errores:
401fallo de autenticación del router,502error del lado del router (detail+error_code),504router inalcanzable,400/422validación de solicitud.
Operaciones principales
| Tarea | Endpoint |
|---|---|
| Resumen (conteo WAN/CPU/mem/nodo y cliente) | GET /dashboard |
| Unidades Deco (nodos mesh) | GET /devices |
| Clientes conectados | GET /clients?online_only=true |
| Clientes bloqueados | GET /clients/blocked |
| Ajustes Wi-Fi (todas las bandas, host/guest) | GET /wireless |
| Wi-Fi ON/OFF por banda | POST /wireless |
| Cambiar SSID/contraseña/canal etc. | POST /wireless/config |
| Estado WAN / internet / LAN / IPv6 | GET /network/wan, /network/internet, /network/lan, /network/ipv6 |
| Uso de CPU / memoria | GET /network/performance |
| Reiniciar unidades Deco (destructivo) | POST /reboot |
| Cualquier otro endpoint Deco (escape) | POST /raw |
| Salud del servidor / inicio de sesión explícito | GET /health, POST /login, POST /logout |
Esquemas completos de solicitud/respuesta y ejemplos de curl listos para ejecutar: consulta references/api-reference.md y references/commands.md.