에이전트 현황

GET https://openapi.exosp.com/status/v1/agent/install

에이전트 현황을 조회하는 API 입니다.

Query Parameters

항목	타입	설명
departmentType*	string	조회대상 department : 그룹 , member : 사용자
departmentFull	string	그룹 전체 경로
email	string	사용자 메일
name	string	사용자 이름
search	string	검색어 검색 대상 : 사용자 이름, 그룹 이름, OS 계정, 컴퓨터 이름, 이메일, auth : 온라인 , unauth : 오프라인, unauth_7days : 7일 이상 오프라인 기본값 : 빈값
sortField	string	정렬을 원하는 컬럼명 user_name : 이름, department_name : 그룹, product_os_user: OS 계정, computer_name: 컴퓨터 이름, time_install: 설치 시각, time_access: 마지막 통신 시각, product_os_type: OS 종류
sortType	string	응답 데이터 정렬 유형 (제어 시각 기준) ASC : 오름차순, DESC : 내림차순
currentPage*	int	((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize*	int	페이지 사이즈
timezone	string	응답 데이터 타임존https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 에서 TZ identifier 참고 기본값 : UTC

Response Schema

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

body 상세

항목	타입	설명
data	array	data 상세
total	int	전체 레코드 수
currentPage	int	((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize	int	페이지 사이즈

data 상세

항목	타입	설명
name	string	사용자 이름
email	string	사용자 메일
departmentFull	string	그룹 전체 경로
departmentName	string	그룹 이름
computerName	string	컴퓨터 이름
osType	string	OS 유형 windows : 윈도우 , macos : 맥
osDescription	string	OS 버전
osUserName	string	OS 계정
computerIP	string	컴퓨터 IP
macAddressList	string	컴퓨터 MAC 주소
agentVersion	string	프로그램 버전
installTimeUTC	string	설치 시각( PC 기준 ) UTC 기준, ISO 8601포맷
dateOfAccessUTC	string	마지막 통신 시각( PC 기준 ) UTC 기준, ISO 8601포맷
unAuth	string	오프라인 여부
isDeleted	string	삭제 여부
installTime	string	설치 시각( 사용자 기준 ) 요청 타임존 기준, ISO 8601포맷
dateOfAccess	string	마지막 통신 시각( 사용자 기준 ) 요청 타임존 기준, ISO 8601포맷

Example

200 Success

curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/agent/install?departmentType=department&departmentFull=your_departmentFull&sortField=user_name&sortType=DESC&currentPage=0&tableSize=1000&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": {
    "data": [
      {
        "name": "test",
        "email": "[email protected]",
        "departmentFull": "test > test1",
        "departmentName": "test1",
        "computerName": "test",
        "osType": "windows",
        "osDescription": "Windows 11 Home 64bit",
        "osUserName": "[email protected]",
        "computerIP": "192.168.0.0",
        "macAddressList": "00:0C:29:10:80:7B",
        "agentVersion": "01.028.00002.00000",
        "installTimeUTC": "2024-06-17T02:15:27+00:00",
        "dateOfAccessUTC": "2025-02-04T05:51:47+00:00",
        "unAuth": "Y",
        "isDeleted": "N",
        "installTime": "2024-06-17T11:15:27+09:00",
        "dateOfAccess": "2025-02-04T14:51:47+09:00"
      }
    ],
    "total": 1,
    "currentPage": 0,
    "tableSize": 1000
  }
}