ADLOG API 사용현황 조회

사용현황 조회

오늘 API 호출 수와 하루 호출 한도, 남은 호출 수를 조회하는 API입니다.
API 호출 수는 하루 기준이며 매일 0시에 초기화됩니다.
사용현황은 1시간에 1회 새로 집계됩니다. 1시간 이내에 다시 요청하면 직전 집계값이 그대로 내려가며, 기준 시각은 check_date 로 확인할 수 있습니다.
이 API 호출은 하루 API 호출 수에 포함되지 않습니다.

⚡Request 정보

MethodPOST

ParameterJSON

전문형태JSON / String

리턴값JSON

POST https://api.adlog.kr/api/getUsage.php

🔑Header

Field	설명	타입	Len	필수	예시	비고
authorization	API Key	String	-	필수	-	API를 사용하기 위한 고유 Key 값

📥Input Parameters

Field	설명	타입	Len	필수	예시	비고
user_id	아이디	String	-	필수	-	회원 아이디

※ 메뉴와 관계없는 API로 api_menu 는 보내지 않아도 됩니다.

💻Request Sample

# 사용현황 조회 API 호출
curl -X POST https://api.adlog.kr/api/getUsage.php \
  -H "authorization: Bearer YOUR-SECRET-KEY" \
  -H "content-Type: application/json" \
  -d '{
    "user_id": "adlog"
}'

<?php
  // 사용현황 조회 API 호출
  $url = "https://api.adlog.kr/api/getUsage.php";

  $headers = array(
    "authorization: Bearer YOUR-SECRET-KEY",
    "content-Type: application/json"
  );

  $postData = array(
    'user_id' => 'adlog'
  );

  $ch = curl_init();

  curl_setopt($ch, CURLOPT_URL, $url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));

  $response = curl_exec($ch);

  curl_close($ch);

  print $response;
?>

📤Output Parameters

Field	설명
code	처리 결과 (0000 : 성공, 이외는 실패)
msg	응답 메시지
items	사용현황
api	오늘 API 호출 현황 (매일 0시 초기화)
date	기준 일자 (YYYY-MM-DD)
used	오늘 호출 수
limit	하루 호출 한도
remain	오늘 남은 호출 수
check_date	사용현황 집계 시각 (YYYY-MM-DD HH:MM:SS)
next_date	다음 집계 가능 시각 (이 시각 전에는 check_date 기준 값이 내려감)
cache	Y : 직전 집계값 / N : 이번 요청에서 새로 집계

💻Response Sample

{
  "code": "0000",
  "msg": "사용현황 조회 성공",
  "items": {
    "api": {
      "date": "2026-11-04",
      "used": 123,
      "limit": 2000,
      "remain": 1877
    }
  },
  "check_date": "2026-11-04 10:00:00",
  "next_date": "2026-11-04 11:00:00",
  "cache": "N"
}

{
  "code": "4002", // 에러 코드 메뉴 참조
  "msg": "API 접근정보를 확인해주세요."
}