> For the complete documentation index, see [llms.txt](https://openapi-docs.exosp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openapi-docs.exosp.com/guide/status/hardware.md).

# 하드웨어 현황

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/status/v2/hardware`

하드웨어 현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>timezone</td><td>string</td><td><p><strong>응답 데이터 타임존</strong><a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">https://en.wikipedia.org/wiki/List_of_tz_database_time_zones</a> 에서 TZ identifier 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름</p><p>기본값 : 빈값</p></td></tr></tbody></table>

### Response Schema

<table><thead><tr><th width="162">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>code</td><td>int</td><td><p><strong>응답 처리 결과 코드</strong> </p><p>0 : 성공, 1 : 실패</p></td></tr><tr><td>message</td><td>string</td><td><p><strong>응답 처리 결과 메세지</strong></p><p>success : 성공, 그 외 : 실패</p></td></tr><tr><td>body</td><td>object</td><td><a data-mention href="#body">#body</a></td></tr></tbody></table>

#### **body 상세**

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>total</td><td>int</td><td><strong>전체 레코드 수</strong></td></tr><tr><td>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>osUserName</td><td>string</td><td><strong>os 계정</strong></td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>osVersion</td><td>string</td><td><strong>os 버전</strong></td></tr><tr><td>macAddress</td><td>string</td><td><strong>mac 주소</strong></td></tr><tr><td>pc</td><td>array</td><td><a data-mention href="#pc">#pc</a></td></tr><tr><td>cpu</td><td>array</td><td><a data-mention href="#cpu">#cpu</a></td></tr><tr><td>mainBoard</td><td>array</td><td><a data-mention href="#mainboard">#mainboard</a></td></tr><tr><td>bios</td><td>array</td><td><a data-mention href="#bios">#bios</a></td></tr><tr><td>memory</td><td>array</td><td><a data-mention href="#memory">#memory</a></td></tr><tr><td>localDisk</td><td>array</td><td><a data-mention href="#localdisk">#localdisk</a></td></tr><tr><td>graphicCard</td><td>array</td><td><a data-mention href="#graphiccard">#graphiccard</a></td></tr><tr><td>monitor</td><td>array</td><td><a data-mention href="#monitor">#monitor</a></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><p><strong>시각</strong></p><p>UTC 기준,  ISO 8601포맷</p></td></tr><tr><td>dateOfEntry</td><td>string</td><td><p><strong>시각</strong></p><p>요청 타임존 기준,  ISO 8601포맷</p></td></tr></tbody></table>

#### pc 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>model</td><td>string</td><td><strong>PC 종류</strong></td></tr><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>uuid</td><td>string</td><td><strong>UUID</strong></td></tr></tbody></table>

#### cpu 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>core</td><td>string</td><td><strong>코어 수</strong></td></tr></tbody></table>

#### mainBoard 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr></tbody></table>

#### bios 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr></tbody></table>

#### memory 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>memoryType</td><td>string</td><td><strong>메모리 종류</strong></td></tr><tr><td>memoryCapacity</td><td>string</td><td><strong>메모리 용량</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr></tbody></table>

#### localDisk 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>storageType</td><td>string</td><td><strong>저장소 종류</strong></td></tr><tr><td>totalCapacity</td><td>string</td><td><strong>전체 용량</strong></td></tr><tr><td>useCapacity</td><td>string</td><td><strong>사용 중</strong></td></tr><tr><td>freeCapacity</td><td>string</td><td><strong>남은 용량</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr></tbody></table>

#### graphicCard 상세

<table><thead><tr><th width="207">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>graphicCardCapacity</td><td>string</td><td><strong>그래픽 카드 용량</strong></td></tr><tr><td>core</td><td>string</td><td><strong>코어 수</strong></td></tr></tbody></table>

#### monitor 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>serialNumber</td><td>string</td><td><strong>일련번호</strong></td></tr><tr><td>productName</td><td>string</td><td><strong>제품명</strong></td></tr><tr><td>manufacturer</td><td>string</td><td><strong>제조사</strong></td></tr></tbody></table>

### Example

{% tabs %}
{% tab title="200 Success" %}

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/hardware?offset=0&tableSize=1&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "total": 24,
    "data": [
        {
                "name": "이수진",
                "departmentName": "웹서비스",
                "departmentFull": "어벤져스 > 제품 > 개발 > 웹서비스",
                "osType": "macos",
                "osUserName": "이수진(sujin)",
                "computerName": "이수진의 Mac mini",
                "pc": [
                    {
                        "model": "Mac mini (M1, 2020)",
                        "serialNumber": "D17PU0A1Q7P0",
                        "uuid": "D188F6BC-C5Q2-6Y0C-78B6-52CD322F3833"
                    }
                ],
                "cpu": [
                    {
                        "serialNumber": null,
                        "manufacturer": null,
                        "productName": "Apple M1",
                        "core": "8"
                    }
                ],
                "mainBoard": [],
                "bios": [],
                "memory": [
                    {
                        "serialNumber": null,
                        "memoryType": "LPDDR4",
                        "memoryCapacity": "16GB",
                        "manufacturer": "Hynix"
                    }
                ],
                "localDisk": [
                    {
                        "serialNumber": null,
                        "storageType": "SSD",
                        "totalCapacity": "494GB",
                        "useCapacity": "32GB",
                        "freeCapacity": "462GB",
                        "productName": "APPLE SSD AP0512Q"
                    }
                ],
                "graphicCard": [
                    {
                        "productName": "Apple M1",
                        "graphicCardCapacity": null,
                        "core": "8"
                    }
                ],
                "monitor": [
                    {
                        "serialNumber": "20515842",
                        "productName": "DELL P2723D",
                        "manufacturer": null
                    },
                    {
                        "serialNumber": "234b5362",
                        "productName": "DELL P2417H",
                        "manufacturer": null
                    }
                ],
                "dateOfEntryUTC": "2024-11-04T23:01:55+00:00",
                "dateOfEntry": "2024-11-05T08:01:55+09:00"
        }
    ]
  }
}
```

{% endtab %}
{% endtabs %}