Deco BE85은(는) 무엇을 하나요?
기본 URL: https://deco.msageha.net/api (TP-Link Deco BE85 로컬 API용 FastAPI 래퍼). 이 인스턴스로의 요청에는 인증 헤더나 쿠키가 필요하지 않습니다. 서버가 저장된 자격 증명을 사용하여 라우터에 직접 로그인합니다.
중요 사항
- 라우터 로그인은 지연(lazy) 방식입니다: 시작 후 또는 유휴 상태 후 첫 번째 호출이 로그인을 트리거하며 속도가 느립니다. 만료된 세션은 자동으로 다시 로그인하여 재시도됩니다.
- 요청은 서버 측 락(단일 라우터 세션) 뒤에서 직렬화됩니다. 엔드포인트를 순차적으로 호출하고, 병렬 요청은 사용하지 마십시오.
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, /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를 참조하십시오.