SIP 등록, DSS 키, 네트워크 옵션, XML 요청 형식 및 지원되는 매개 변수 검색을 포함하여 Postman을 사용하여 HTTP API를 통해 장치 설정을 구성하는 방법에 대해 알아보십시오.
이 가이드는 HTTP API를 통해 장치 매개변수를 구성하는 방법을 설명합니다. 여기에는 SIP 서버 설정, SIP 계정 등록 세부 정보, DSS 키 매개변수 및 기타 장치 옵션이 포함됩니다. 장치는 HTTP 서버 역할을 하고 클라이언트는 특정 HTTP 요청을 보내 구성 변경 사항을 적용합니다(아래 그림 참조).
이 예에서는 Postman을 사용하여 장치로 전송되는 HTTP 요청을 시뮬레이션합니다.
당사 제품 라인의 현재 사용 가능한 모든 전화 모델.
① 최신 펌웨어 버전으로 업그레이드되고 PoE 스위치에 연결된 BHP-SOS11V 인터콤 장치 1대.
② Postman이 설치된 구성용 PC 1대, 동일한 스위치에 연결되고 정상적인 네트워크 통신이 확인되어야 함.
Postman을 다음에서 다운로드하세요:
https://www.postman.com/downloads/
그런 다음 설치 지침에 따라 설정을 완료합니다.
File – New를 클릭한 다음 HTTP Request를 선택합니다.
새 요청 창에서 POST 메서드를 선택하고 다음 형식으로 장치 HTTP URL을 입력합니다:
http://ip/xmlservice
URL은 대소문자를 구분합니다. ip를 실제 장치 IP 주소로 바꿉니다(아래 그림 참조).
그런 다음 필요한 HTTP 요청 매개변수를 구성합니다:
인증 방법: Basic Auth
헤더: Content-Type: xml/text
Body를 클릭하고 raw를 선택한 다음 메시지 본문에 XML 내용을 입력합니다. 샘플 형식은 아래와 같습니다.
구조는 다음과 같습니다:
이것은 XML 선언 헤더이며 모든 요청에 필요합니다.
이것은 XML 명령 구조를 정의합니다. cmd 속성은 현재 매개변수를 가져오는 get 또는 새 매개변수를 쓰는 set일 수 있습니다.
이것은 실제 구성 항목을 지정합니다. 이 예에서 요청은 장치에서 SIP 라인 관련 매개변수를 가져옵니다.
실제 사용 시 다음 섹션은 실제로 쿼리하거나 구성하려는 매개변수에 따라 조정되어야 합니다:
모델에 따라 지원되는 HTTP API 매개변수가 다를 수 있습니다. 다음 방법 중 하나를 사용하여 특정 장치에 대해 지원되는 매개변수 목록을 얻을 수 있습니다.
방법 1: 장치의 WEB 인터페이스에서 System – System Configuration으로 이동한 다음 nc 유형의 구성 파일을 내보냅니다.
마우스 오른쪽 버튼을 클릭하여 파일을 저장하거나 왼쪽 버튼을 클릭하여 구성을 직접 볼 수 있습니다. 일반적인 매개변수는 다음 섹션에 나열되어 있습니다.
방법 2: 일부 모델은 웹 인터페이스에 nc 구성 파일 링크를 직접 제공하지 않습니다. 이 경우 브라우저 주소 표시줄에 해당 URL을 입력하여 nc 구성 파일을 수동으로 가져올 수 있습니다.
참고: 이 방법은 응답하는 데 시간이 더 오래 걸릴 수 있습니다.
이 섹션에서는 참조를 위해 몇 가지 일반적인 매개변수를 나열합니다. 향후 업데이트에서 더 많은 매개변수가 추가될 수 있습니다.
SIP 라인 매개변수 예(i30 출입 통제 장치에서):
sip.line.1.PhoneNumber = 112
sip.line.1.DisplayName = 112
sip.line.1.SipName =
sip.line.1.RegAddr = 172.18.1.45
sip.line.1.RegPort = 2066
sip.line.1.RegUser = 112
sip.line.1.RegPswd = abc123
sip.line.1.RegTTL = 3600
sip.line.1.RegEnabled = 0
sip.line.1.은 이러한 매개변수가 SIP 라인 1에 속함을 나타냅니다.
PhoneNumber는 웹 인터페이스의 전화번호 필드에 해당합니다.
DisplayName은 표시 이름에 해당합니다.
RegAddr은 SIP 프록시 서버 주소입니다.
RegPort는 SIP 프록시 서버 포트입니다.
RegUser는 인증 사용자 이름으로, 일반적으로 전화번호와 동일합니다.
RegPswd는 비밀번호입니다.
RegTTL은 등록 만료 시간으로 기본값은 3600초입니다.
RegEnabled는 라인 활성화 여부를 정의합니다: 0은 비활성화, 1은 활성화를 의미합니다.
i30에 대한 DSS 키 매개변수 예:
먼저 웹 인터페이스에서 DSS 키를 구성한 다음 get 명령과 함께 HTTP API를 사용하여 해당 매개변수 값을 읽어 정확한 매핑을 확인하는 것이 좋습니다.
Type=1은 i30 또는 i12와 같은 장치의 DSS 키 유형이 Hotkey임을 나타냅니다. 다른 모델의 경우 위의 권장 방법을 사용하여 실제 유형 값을 확인하십시오.
Value=125@1/f의 의미:
125 = 대상 번호
@1 = 라인 1
/f = 하위 유형: 단축 다이얼
i30 및 i12와 같은 장치의 네트워크 매개변수 예:
