O que Deco BE85 faz?
URL Base: https://deco.msageha.net/api (wrapper FastAPI em torno da API local do TP-Link Deco BE85). Requisições a esta instância não precisam de cabeçalho/cookie de autenticação — o servidor faz login no roteador automaticamente com credenciais armazenadas.
Fatos importantes
- O login no roteador é tardio: a primeira chamada após a inicialização/ociosidade o aciona e é mais lenta. Sessões expiradas são re-logadas e repetidas automaticamente.
- Requisições são serializadas por um lock no lado do servidor (sessão única do roteador). Chame os endpoints sequencialmente; não dispare requisições em paralelo.
bandéband2_4/band5_1/band6;networkéhost/guest.GET /wirelessretornassid/passwordcodificados em base64; endpoints de escrita aceitam texto simples (o servidor os codifica).- Confirme com o usuário antes de qualquer escrita: alternâncias/alterações de configuração de Wi-Fi desconectam clientes naquela banda brevemente,
POST /reboot(requerconfirm: true) derruba toda a rede por minutos, ePOST /rawcom umaoperationnão-leitura pode alterar configurações arbitrárias do roteador. - Erros:
401falha de autenticação do roteador,502erro no lado do roteador (detail+error_code),504roteador inalcançável,400/422validação de requisição.
Operações principais
| Tarefa | Endpoint |
|---|---|
| Visão geral (WAN/CPU/mem/nós e contagens de clientes) | GET /dashboard |
| Unidades Deco (nós de malha) | GET /devices |
| Clientes conectados | GET /clients?online_only=true |
| Clientes bloqueados | GET /clients/blocked |
| Configurações de Wi-Fi (todas as bandas, host/guest) | GET /wireless |
| Wi-Fi LIGA/DESLIGA por banda | POST /wireless |
| Alterar SSID/senha/canal etc. | POST /wireless/config |
| Status WAN / internet / LAN / IPv6 | GET /network/wan, /network/internet, /network/lan, /network/ipv6 |
| Uso de CPU / memória | GET /network/performance |
| Reinicializar unidades Deco (destrutivo) | POST /reboot |
| Qualquer outro endpoint do Deco (saída de emergência) | POST /raw |
| Status do servidor / login explícito | GET /health, POST /login, POST /logout |
Esquemas completos de requisição/resposta e exemplos curl prontos para uso: veja references/api-reference.md e references/commands.md.