Network 관련 서비스

 본 서비스는 eXDevice+가 설치된 로컬 PC의 네트워크 관련 정보 획득을 지원합니다.

서비스 리스트

 Network 관련 서비스 리스트는 다음과 같습니다.

No.	서비스명	API 명	비고
1	로컬 IPv4 주소 획득	WinInfo.GetIpAddress
2	로컬 MAC 주소 획득	WinInfo.GetMacAddress

서비스 상태 코드 리스트

 본 서비스에서 공통으로 사용되는 서비스 상태코드 리스트에 대해 정의합니다.

 이 상태 코드는 응답 JSON 메시지 중 return 또는 returnValue의 값에 해당합니다.

리턴코드	리턴 코드 내용	대상 서비스	비고
-1	정의되지 않은 예외	공통	Log 파일에서 내용 확인 필요
0	정상	공통	-
1	시스템 Lan 카드 정보 획득 실패	WinInfo.GetIpAddress	-

1. 로컬 IPv4 주소 획득

API명

• WinInfo.GetIpAddress

정의

• 로컬 PC에서 활성화된 Lan 카드의 IPv4 주소를 획득합니다.

호출 예시

{
  "service":"WinInfo.GetIpAddress",
  "requestKey":"Random Request Key",
  "param":{}
}

응답 예시

{
  "service":"WinInfo.GetIpAddress",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":{
    "returnValue":0,
    "systemIpv4":"123.123.123.123"
  }
}

• returnValue
  • 서비스 상태 코드.
• systemIpv4
  • 활성 된 Lan 카드 IPv4 주소.

2. 로컬 MAC 주소 획득

API명

• WinInfo.GetMacAddress

정의

• 현재 활성화된 Lan 카드의 MAC 주소를 획득합니다.

호출 예시

{
  "service":"WinInfo.GetMacAddress",
  "requestKey":"Random Request Key",
  "param":{}
}

응답 예시

{
  "service":"WinInfo.GetMacAddress",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":{
    "returnValue":0,
    "systemMacAddr":"ABCDEF12345"
  }
}

• returnValue
  • 서비스 상태 코드.
• systemIpv4
  • 활성 된 Lan 카드 MAC 주소.