API Try-it 안내

API 레퍼런스의 각 제품 페이지에는 Playground(Try-it) 콘솔이 함께 제공됩니다. 브라우저에서 직접 장비의 REST API를 호출해 응답을 확인할 수 있고, 각 오퍼레이션에는 copy-as-curl(cURL 명령 복사) 버튼이 있어 직접 호출이 어려운 환경에서도 동일 요청을 터미널에서 실행할 수 있습니다.

1. 장비 주소 입력

Playground 상단의 서버 변수 device_ip에 대상 장비의 IP(예: 192.168.0.30)를 입력하세요. 장비가 API를 직접 서빙하므로, 같은 네트워크(또는 P2P 직결) 안에서 접근 가능한 주소여야 합니다.

2. 브라우저 지원

브라우저	브라우저 직접 호출	조건
Chrome / Edge 142+	가능	사설 IP 대상 최초 1회 로컬 네트워크 접근(LNA) 권한 허용 후
Firefox 149/151+	대체로 가능	동일 LNA 모델, 점진 롤아웃 중
Safari	불가	사설망 mixed content 차단 — copy-as-curl 사용

💡 참고: 이 문서 사이트는 HTTPS이고 장비 API는 사설망 HTTP입니다. Chrome/Edge 142+는 사설 IP 리터럴 대상에 대해 mixed content를 자동 면제하고, 최초 1회 로컬 네트워크 접근(LNA) 권한 프롬프트를 띄웁니다. 허용하면 이후 정상 호출됩니다.

3. 직접 호출이 막힐 때 — copy-as-curl 폴백

Safari·구형 브라우저이거나, 인증(Basic Auth)이 포함된 교차 출처 요청이 브라우저 정책으로 차단되는 경우에는 각 오퍼레이션의 copy-as-curl 버튼으로 cURL 명령을 복사해 터미널에서 실행하세요. 모든 브라우저·환경에서 동일하게 동작합니다.

curl -u admin:<password> http://192.168.0.30/setting/status

4. 문제 해결

• LNA 프롬프트가 안 뜨거나 거부한 경우 → 브라우저 사이트 권한에서 로컬 네트워크 접근을 허용하세요.

• Safari는 사설망 mixed content를 차단하므로 직접 호출이 불가합니다 → copy-as-curl을 사용하세요.

• 인증이 필요한 요청은 사용자명·비밀번호를 입력하세요. 장비 기본 계정은 최초 접속 시 반드시 변경해야 합니다.