웹 접속 관리 내역

웹 접속 관리 내역 조회

GET https://openapi.exosp.com/logs/v1/web-control

웹 접속 관리 내역을 조회하는 API 입니다.

Query Parameters

항목	타입	설명
offset*	int	((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize*	int	페이지 사이즈
startTimeUTC*	string	응답 데이터 시작 시각 UTC 기준, ISO 8601포맷 ✅ 최신 3개월 이내의 시각만 입력해주세요.
endTimeUTC*	string	응답 데이터 종료 시각 UTC 기준, ISO 8601포맷
sortType*	string	응답 데이터 정렬 유형 (제어 시각 기준) ASC : 오름차순, DESC : 내림차순
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	컴퓨터 이름
category	string	웹 사이트 카테고리 Others : 기타, Web Mail : 웹메일, Shopping : 쇼핑, Finance : 증권, Job Search : 취업, Gaming : 게임, Entertainment : 엔터테인먼트, News : 뉴스, Social Networking : SNS, P2P/Cloud Storage : 웹하드/클라우드 스토리지, P2P : 웹하드, Cloud Storage : 클라우드 스토리지, Pornography/Harmful : 성인/유해
siteTitle	string	웹 사이트 제목
url	string	웹 사이트 주소
urlHash	string	웹 사이트 해시
controlType	string	제어 유형 Warning : 경고, Block : 차단
dateOfEntryUTC	string	시각 UTC 기준, ISO 8601포맷
dateOfEntry	string	시각 요청 타임존 기준, ISO 8601포맷

Example

200 Success

curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/web-control?offset=0&tableSize=1&startTimeUTC=2024-05-01T15%3A00%3A00%2B00%3A00&endTimeUTC=2024-08-01T15%3A00%3A00%2B00%3A00&timezone=Asia%2FSeoul&sortType=DESC' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 
  
{
  "code": 0,
  "message": "success",
  "body": {
    "total": 18,
    "data": [
        {
                "name": "김민지",
                "departmentName": "맥/크로스플랫폼",
                "departmentFull": "어벤져스 > 제품 > 개발 > 맥/크로스플랫폼",
                "osType": "macos",
                "osUserName": "minji(minji)",
                "computerName": "minji의 MacBook Air",
                "category": "Gaming",
                "siteTitle": "넥슨",
                "url": "www.nexon.com/Home/Game",
                "urlHash": "5adbc8e6db30a26cdd3a25369a82360d412a4e8f96919ab22d1e34468eca9542",
                "controlType": "Block",
                "dateOfEntryUTC": "2024-11-28T12:18:18+00:00",
                "dateOfEntry": "2024-11-28T21:18:18+09:00"
        }
    ]
  }
}