LOGGER REST API 연동 가이드: 토큰 인증 · 주요 엔드포인트 · 호출 한도 · 사내 대시보드 설계

    갱신일 2026. 11. 16. · 작성 비즈스프링 LOGGER팀

    LOGGER REST API는 개발자가 사내 시스템이나 BI 도구에서 LOGGER 리포트 데이터를 HTTP로 조회하는 방법입니다. 계약은 OpenAPI 3.1 명세로 제공하며, MCP와 같은 조회 기능 · 같은 계정 권한 · 같은 호출 한도(서비스별 하루 1,000회, MCP와 합산)를 사용합니다. 연동은 LOGGER 요금에 포함되어 있어 별도 과금이 없습니다.

    REST API와 MCP, 언제 무엇을 쓰는가

    LOGGER는 리포트 데이터를 콘솔 화면 밖에서 조회하는 두 가지 방법을 제공합니다. MCP는 Claude · ChatGPT 같은 AI 서비스에 LOGGER를 연결해 대화로 분석하는 방법이고, REST API는 개발자가 자사 시스템에서 데이터를 불러오는 방법입니다. 두 방법은 같은 조회 기능과 같은 계정 권한을 사용하므로, 목적에 따라 고르면 됩니다.

    목적별 방법 선택 기준(LOGGER 매뉴얼 「MCP/API 서비스 개요」 기준)
    목적권장 방법이유
    여러 리포트를 함께 질문하고 표와 해석을 받으려는 경우MCP(Claude · ChatGPT)AI가 리포트를 골라 조회하고 문장으로 정리합니다.
    사내 시스템 · BI 도구에서 정기적으로 수치를 불러오려는 경우REST APIOpenAPI 명세로 클라이언트를 생성해 같은 형식으로 반복 조회합니다.
    터미널에서 AI 코딩 도구로 분석하려는 경우MCP(Claude Code)명령 한 줄로 연결하고 스크립트 작업과 함께 씁니다.
    원본 행동 데이터를 사내 AI · BI에 실시간으로 공급하려는 경우구축형(On-Premise) 실시간 데이터 파이프라인리포트 조회 API가 아니라 별도 구축 사업으로 진행합니다.

    인증: 토큰 발급과 보관

    1. 1

      토큰 발급

      POST https://logger.co.kr/apis/v1/auth/token 에 loginId, password, scope(read)를 JSON으로 전송해 토큰(lgr_로 시작)을 발급받습니다. 연동용 토큰은 조회 전용입니다.

    2. 2

      헤더 설정

      이후 모든 요청의 Authorization 헤더에 「Bearer <발급받은 토큰>」을 입력합니다.

    3. 3

      서비스 확인

      GET /apis/v1/services 로 조회할 수 있는 서비스와 서비스 번호(loggerId)를 확인합니다. 이 번호를 이후 리포트 조회의 기준으로 씁니다.

    4. 4

      만료 처리

      토큰은 로그인 세션 토큰이므로 12시간 뒤 만료됩니다. 배치 작업은 실행할 때마다 토큰을 새로 발급하도록 구성합니다.

    주요 엔드포인트와 리포트 조회 순서

    LOGGER REST API 주요 경로(LOGGER 매뉴얼 「REST API 사용 방법」에 수록된 경로, 기본 주소 https://logger.co.kr/apis)
    메서드 · 경로용도비고
    POST /v1/auth/token토큰 발급loginId · password · scope(read), 12시간 뒤 만료
    GET /v1/services조회 가능한 서비스(loggerId) 목록서비스를 지정하지 않는 호출이라 계정별로 집계
    GET /v1/reports리포트 코드 목록어떤 리포트를 조회할지 정합니다
    GET /v1/reports/{code}/schema차원 · 지표 · 필터 정의?include=values 로 필터 값 형태 확인
    GET /v1/reports/{code}/data리포트 실데이터 조회loggerId · ps · pe · groupBy · filter 등
    GET /v1/usage?loggerId=오늘 남은 호출 수 확인응답 헤더 X-RateLimit-Remaining 으로도 확인
    GET /v1/skills · /v1/skills/{id}사용 절차서 목록 · 본문REST 규약은 id가 api-guide인 절차서
    리포트 데이터를 조회하는 순서
    1. 단계 1
      토큰 발급
      /v1/auth/token
    2. 단계 2
      서비스 확인
      /v1/services
    3. 단계 3
      리포트 코드
      /v1/reports
    4. 단계 4
      스키마 확인
      /schema
    5. 단계 5
      데이터 조회
      /data

    groupBy는 한 요청에 하나만 지정합니다. 두 기준을 함께 보려면 한 기준으로 나누고 다른 기준은 filter로 좁혀 여러 번 조회합니다. filter 값에는 화면에 표시되는 이름이 아니라 응답 rows의 value를 그대로 입력해야 0건 응답을 피할 수 있습니다. 응답은 성공이면 { ok: true, data, meta }, 실패면 { ok: false, error: { code, message, http, ref } } 형식이며, 4xx 오류는 message에 수정할 내용이 구체적으로 표시됩니다. 5xx 오류는 참조 코드(ref)만 제공하므로 문의할 때 함께 전달합니다.

    호출 한도와 응답 코드

    REST API 호출 한도(LOGGER 매뉴얼 기준)
    항목내용
    한도서비스(loggerId)별 하루 1,000회. MCP와 합산하며, 같은 서비스를 조회하는 모든 계정의 호출을 합산합니다.
    초기화한국 시각 자정
    남은 횟수 확인GET /v1/usage?loggerId= 또는 응답 헤더 X-RateLimit-Limit · X-RateLimit-Remaining
    초과 시429 RATE_LIMITED와 Retry-After 헤더가 반환됩니다.
    집계하지 않는 호출토큰 발급, 절차서 조회, 매뉴얼 조회

    사내 대시보드 연동 설계

    사내 대시보드에 LOGGER 지표를 표시할 때는 필요한 지표를 먼저 정하고, 그 지표에 해당하는 리포트를 정해진 주기로 조회하는 구조가 안정적입니다. 리포트 수와 조회 주기로 하루 호출 수를 미리 계산해 두면 한도 안에서 운영할 수 있습니다.

    1. 1

      지표 정의

      대시보드에 표시할 지표(방문수 · 전환수 · 매출 · 채널별 유입 등)와 기준 기간을 문서로 정합니다.

    2. 2

      리포트 코드와 스키마 고정

      지표마다 리포트 코드, groupBy, filter 값을 정해 설정 파일로 관리합니다. 스키마는 정기적으로 다시 확인합니다.

    3. 3

      주기 조회

      전일 집계값을 하루 한 번 조회하는 배치를 기본으로 합니다. 같은 기간을 여러 번 조회하지 않도록 결과를 사내 저장소에 보관합니다.

    4. 4

      표시와 점검

      대시보드는 사내 저장소의 값을 읽어 표시합니다. 배치 마지막 단계에서 /v1/usage로 남은 호출 수를 기록해 한도 사용량을 점검합니다.

    하루 호출 수 계산 예시(예시이며 실제 리포트 수는 사내 요구에 따라 달라집니다)
    구성계산하루 호출 수(예시)
    토큰 발급집계하지 않음0회
    리포트 8종 전일값 조회8종 × 1회8회
    채널별 · 디바이스별 분할 조회2종 × 기준 5개10회
    남은 횟수 확인1회1회
    합계약 19회(한도 1,000회 대비 여유)

    자주 묻는 질문

    Q. REST API 토큰은 얼마 동안 유효한가요?

    로그인 세션 토큰이므로 12시간 뒤 만료됩니다. 만료되면 POST /apis/v1/auth/token 으로 다시 발급합니다. 토큰 발급 호출은 하루 호출 한도에 집계하지 않습니다.

    Q. REST API로 설정을 바꿀 수 있나요?

    연동용 토큰은 조회 전용입니다. 설정 변경은 LOGGER 콘솔에서 하며, AI 서비스에서 설정을 바꾸려면 MCP를 읽기 · 쓰기 권한으로 연결합니다.

    Q. Postman이나 ChatGPT Actions에서 바로 쓸 수 있나요?

    가능합니다. OpenAPI 3.1 명세 주소(/apis/openapi.yaml)를 가져오면 경로와 파라미터가 자동으로 구성됩니다. 토큰은 Bearer 인증으로 입력합니다.

    Q. 하루 1,000회보다 많이 호출해야 하면 어떻게 하나요?

    한도는 대량 데이터 추출을 막기 위한 정책이므로 늘리지 않습니다. 조회 주기와 범위를 조정하고, 많은 자료는 리포트 통합 다운로드를 이용하십시오. 원본 데이터의 실시간 공급이 필요하면 구축형 실시간 데이터 파이프라인을 상담하실 수 있습니다.

    Q. API로 조회한 값과 콘솔 화면의 값이 다르면 무엇을 확인하나요?

    조회 기간(ps · pe), 서비스 번호(loggerId), filter 값이 화면 조건과 같은지 확인합니다. filter에는 화면 표시 이름이 아니라 응답 rows의 value를 넣어야 합니다.

    FAQ 100개 전체 보기

    참고 자료

    LOGGER로 직접 확인해 보십시오

    14일 무료체험을 제공하며, 기본 스크립트 설치를 무상으로 대행합니다.