# Network 관련 서비스

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

## 서비스 리스트

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

<table border="1" id="bkmrk-no.-%EC%84%9C%EB%B9%84%EC%8A%A4%EB%AA%85-api-%EB%AA%85-%EB%B9%84%EA%B3%A0-1-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 7.03218%;"></col><col style="width: 28.9631%;"></col><col style="width: 33.969%;"></col><col style="width: 30.0358%;"></col></colgroup><thead><tr><td class="align-center">**No.**</td><td class="align-center">**서비스명**</td><td class="align-center">**API 명**</td><td class="align-center">비고</td></tr></thead><tbody><tr><td class="align-center">1</td><td>로컬 IPv4 주소 획득</td><td>WinInfo.GetIpAddress</td><td>  
</td></tr><tr><td class="align-center">2</td><td>로컬 MAC 주소 획득</td><td>WinInfo.GetMacAddress</td><td>  
</td></tr></tbody></table>

## 서비스 상태 코드 리스트

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

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

<table border="1" id="bkmrk-%EB%A6%AC%ED%84%B4%EC%BD%94%EB%93%9C-%EB%A6%AC%ED%84%B4-%EC%BD%94%EB%93%9C-%EB%82%B4%EC%9A%A9-%EB%8C%80%EC%83%81-%EC%84%9C%EB%B9%84%EC%8A%A4-2" style="border-collapse: collapse; width: 100%; height: 595.938px;"><colgroup><col style="width: 8.70083%;"></col><col style="width: 45.4112%;"></col><col style="width: 23.0036%;"></col><col style="width: 23.0036%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**리턴코드**</td><td class="align-center" style="height: 29.7969px;">**리턴 코드 내용**</td><td class="align-center" style="height: 29.7969px;">**대상 서비스**</td><td class="align-center" style="height: 29.7969px;">**비고**</td></tr></thead><tbody><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">-1</td><td style="height: 29.7969px;">정의되지 않은 예외</td><td style="height: 29.7969px;">공통</td><td style="height: 29.7969px;">Log 파일에서 내용 확인 필요</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">0</td><td style="height: 29.7969px;">정상</td><td style="height: 29.7969px;">공통</td><td style="height: 29.7969px;">-</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">1</td><td style="height: 29.7969px;">시스템 Lan 카드 정보 획득 실패</td><td style="height: 29.7969px;">WinInfo.GetIpAddress</td><td style="height: 29.7969px;">-</td></tr></tbody></table>

## 1. 로컬 IPv4 주소 획득

**API명**

- WinInfo.GetIpAddress

**정의**

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


**호출 예시**

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

**응답 예시**

```json
{
  "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 주소를 획득합니다.

**호출 예시**

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

**응답 예시**

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

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