API 요청 및 응답 모델

주의 및 제한 사항

  • 모든 API 요청에는 유효한 x-exosp-access와 x-exosp-secret 헤더가 포함되어야 합니다.

  • Access Key당 하루 최대 1,000번의 API 호출이 허용됩니다.

  • 한 번의 호출로 최대 1,000개의 레코드만 요청할 수 있습니다

  • 대량의 데이터를 요청할 경우, 페이징 기법을 사용하세요.

  • 요청 및 응답에 포함된 모든 시간 데이터는 ISO 8601 형식을 따릅니다.

  • 응답 데이터는 JSON 형식으로 제공됩니다.

  • 최신 3개월 이내의 데이터만 조회 가능합니다.

  • 구독 종료 혹은 OpenAPI 기능 미사용 시 호출이 제한됩니다.

요청

Host

  • https://openapi.exosp.com

Header

  • accept: application/json

  • x-exosp-access: 발급 받은 Access Key

  • x-exosp-secret: 발급 받은 Secret Key

Method

  • GET

공통 요청 데이터

항목
타입
설명

offset

int

((현재 페이지 번호 -1)*tableSize) 페이징 처리를 위한 데이터입니다.

현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.

tableSize

int

페이지 사이즈

페이징 처리를 위한 데이터입니다. (최대값 : 1000)

timezone

string

Request 예제
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/ip?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

int

응답 처리 결과 코드

0 : 성공, 1 : 실패

message

string

응답 처리 결과 메세지

success : 성공, 그 외 : 실패

body

object

응답 데이터

각 기능에 따라 세부 내용이 다릅니다.

(성공) Response 예제
{
  "code": 0,
  "message": "success",
  "body": {
    "total": 24,
    "data": [
      {
        "name": "신은진",
        "departmentName": "디자인",
        "departmentFull": "어벤져스 > 비즈니스 > 디자인",
        "computerName": "어변져스의 iMac",
        "osType": "macos",
        "osDescription": "Sonoma",
        "osUserName": "어변져스(designer)",
        "publicIP": "211.171.171.190",
        "privateIP": "10.100.73.10",
        "dateOfEntryUTC": "2024-07-15T23:27:08+00:00",
        "dateOfEntry": "2024-07-16T08:27:08+09:00"
      }
    ]
  }
}
(실패) Response 예제
{
  "code": 1,
  "message": "tableSize cannot be greater than 1000"
}
PreviousAPI 키Next로그

Last updated