하드웨어 현황

하드웨어 현황 조회

GET https://openapi.exosp.com/status/v1/hardware

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

Query Parameters

항목	타입	설명
offset*	int	((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize*	int	페이지 사이즈
timezone	string	응답 데이터 타임존https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 에서 TZ identifier 참고 기본값 : UTC
search	string	검색어 검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름 기본값 : 빈값

Response Schema

항목	타입	설명
code	int	응답 처리 결과 코드 0 : 성공, 1 : 실패
message	string	응답 처리 결과 메세지 success : 성공, 그 외 : 실패
body	object	body 상세

body 상세

항목	타입	설명
total	int	전체 레코드 수
data	array	data 상세

data 상세

항목	타입	설명
name	string	사용자 이름
departmentName	string	그룹 이름
departmentFull	string	그룹 전체 경로
osType	string	os 유형 windows : 윈도우 , macos : 맥
osUserName	string	os 계정
computerName	string	컴퓨터 이름
pc	array	pc 상세
cpu	array	cpu 상세
mainBoard	array	mainBoard 상세
bios	array	bios 상세
memory	array	memory 상세
localDisk	array	localDisk 상세
graphicCard	array	graphicCard 상세
monitor	array	monitor 상세
dateOfEntryUTC	string	시각 UTC 기준, ISO 8601포맷
dateOfEntry	string	시각 요청 타임존 기준, ISO 8601포맷

pc 상세

항목	타입	설명
model	string	PC 종류
serialNumber	string	일련번호
uuid	string	UUID

cpu 상세

항목	타입	설명
serialNumber	string	일련번호
manufacturer	string	제조사
productName	string	제품명
core	string	코어 수

mainBoard 상세

항목	타입	설명
serialNumber	string	일련번호
productName	string	제품명
manufacturer	string	제조사

bios 상세

항목	타입	설명
serialNumber	string	일련번호
productName	string	제품명
manufacturer	string	제조사

memory 상세

항목	타입	설명
serialNumber	string	일련번호
memoryType	string	메모리 종류
memoryCapacity	string	메모리 용량
manufacturer	string	제조사

localDisk 상세

항목	타입	설명
serialNumber	string	일련번호
storageType	string	저장소 종류
totalCapacity	string	전체 용량
useCapacity	string	사용 중
freeCapacity	string	남은 용량
productName	string	제품명

graphicCard 상세

항목	타입	설명
productName	string	제품명
graphicCardCapacity	string	그래픽 카드 용량
core	string	코어 수

monitor 상세

항목	타입	설명
serialNumber	string	일련번호
productName	string	제품명
manufacturer	string	제조사

Example

200 Success

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"
        }
    ]
  }
}