OpenAPI 이용방법

🔑API Key 발급

본 API는 애드로그 회원만 이용할 수 있습니다.
회원가입 후 관리자에게 API 사용을 요청하시면 API Key를 발급받을 수 있습니다.
발급받은 API Key는 외부에 절대 노출하지 마세요.

📋메뉴 값

각 API 호출 시 api_menu 파라미터에 해당 메뉴 코드를 입력해야 합니다.
아래 메뉴 정보 페이지에서 코드 값을 확인해 주세요.

🧪테스트 진행

API Key를 발급받으시면 테스트 환경에서 바로 이용할 수 있습니다.
테스트 진행 중에는 API를 통해서만 등록/조회가 가능합니다.
방화벽 설정이 필요한 경우, 별도로 IP를 전달해 주시면 처리해 드립니다.
과도한 트래픽 발생 시 사전 안내 없이 차단될 수 있으며, 차단 해제는 관리자에게 요청해 주세요.

🚀실사용

테스트 완료 후 이상이 없으면 관리자에게 실사용 전환을 요청해 주세요.
실사용 전환 후에는 API로 등록한 데이터를 애드로그 홈페이지에서도 확인할 수 있습니다.
과도한 트래픽 발생 시 사전 안내 없이 차단될 수 있으며, 차단 해제는 관리자에게 요청해 주세요.

📊일 사용량 안내

멤버십 등급에 따라 등록 가능한 슬롯 수와 API 호출 한도가 제공됩니다.

■ 슬롯 사용 안내

키워드 등록 및 업체(링크) 등록 수는 멤버십 슬롯에 포함됩니다.
등록된 키워드 및 업체(링크)의 총합이 보유 슬롯 수를 초과할 수 없습니다.

예시)
멤버십 100개 이용 시 → 최대 100개까지 등록 가능
멤버십 300개 이용 시 → 최대 300개까지 등록 가능

■ API 호출 한도 안내

API 일일 호출(조회) 가능 횟수는 아래와 같습니다.

멤버십	일일 호출 한도
멤버십 100개	일 2,000회
멤버십 300개	일 6,000회
멤버십 500개	일 10,000회
멤버십 1,000개	일 20,000회

※ 일일 호출 한도 = 멤버십 슬롯 수 × 20

애드로그는 안정적인 서비스 제공을 위해 API 사용량을 관리하고 있으며, 원활한 운영을 위해 정책이 변경될 수 있습니다.

💻Request Sample

# 플레이스 키워드 조회 기준 샘플
curl -X POST https://www.adlog.kr/api/getKeywordList.php \
  -H "authorization: Bearer YOUR-SECRET-KEY" \
  -H "content-Type: application/json" \
  -d '{
    "user_id": "adlog",
    "api_menu": "1064",
    "page": "1",
    "api_no": "1",
    "group_no": "1",
    "keyword": "홍대 맛집",
    "keyword2": "1287775548",
    "memo": "맛집체크",
    "group_name": "맛집2",
    "group_memo": "맛집2"
  }'

<?php
  // 플레이스 키워드 조회 기준 샘플 소스
  $url = "https://www.adlog.kr/api/getKeywordList.php";

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

  // 각 API에 맞춰 필요값만 사용
  $postData = array(
    'user_id'     => 'adlog',
    'api_menu'    => '1064',
    'page'        => '1',
    'api_no'      => '1',
    'group_no'    => '1',
    'keyword'     => '홍대 맛집',
    'keyword2'    => '1287775548',
    'memo'        => '맛집체크',
    'group_name'  => '맛집2',
    'group_memo'  => '맛집2'
  );

  $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;
?>

ADLOG API

OpenAPI 이용방법