{
  "slug": "ref/web/logger-co-kr/logger-rest-api-연동-가이드-토큰-인증-주요-엔드포인트-호출-한도-사내-대시보드-설계-logger-bizspring",
  "doc_type": "ref",
  "title": "LOGGER REST API 연동 가이드: 토큰 인증 · 주요 엔드포인트 · 호출 한도 · 사내 대시보드 설계 | LOGGER™ : BizSpring",
  "title_en": null,
  "one_liner": "LOGGER REST API 연동 가이드: 토큰 인증 · 주요 엔드포인트 · 호출 한도 · 사내 대시보드 설계 LOGGER™ : BizSpring MCP 로그인 문의하기 LOGGER REST API 연동 가이드: 토큰 인증 · 주요 엔드포인트 · 호출 한도 · 사내 대시보드",
  "summary_bullets": [
    "LOGGER REST API는 개발자가 사내 시스템·BI 도구에서 LOGGER 리포트 데이터를 HTTP로 조회하는 방법이며 OpenAPI 3.1 명세로 제공됩니다.",
    "토큰 발급(/v1/auth/token) 후 Bearer 인증으로 호출하며, 토큰은 조회 전용이고 12시간 뒤 만료됩니다.",
    "리포트는 목록 → 스키마 → 데이터 순서로 조회하며, 호출 한도는 서비스별 하루 1,000회로 MCP와 합산됩니다.",
    "한도 초과 시 429가 반환되며 재시도하지 않고, 대량 자료는 리포트 통합 다운로드나 구축형 실시간 데이터 파이프라인을 검토합니다.",
    "사내 대시보드는 지표 정의 → 리포트 코드·스키마 고정 → 주기 조회 → 표시·점검 순으로 설계하면 호출 한도 안에서 안정적으로 운영할 수 있습니다."
  ],
  "body_md": "LOGGER REST API 연동 가이드: 토큰 인증 · 주요 엔드포인트 · 호출 한도 · 사내 대시보드 설계 | LOGGER™ : BizSpring\n\nMCP 로그인 문의하기\n\n# LOGGER REST API 연동 가이드: 토큰 인증 · 주요 엔드포인트 · 호출 한도 · 사내 대시보드 설계\n\n갱신일 2026. 11. 16. · 작성 비즈스프링 LOGGER팀\n\n지식센터 FAQ 서비스 비교\n\nLOGGER REST API는 개발자가 사내 시스템이나 BI 도구에서 LOGGER 리포트 데이터를 HTTP로 조회하는 방법입니다. 계약은 OpenAPI 3.1 명세로 제공하며, MCP와 같은 조회 기능 · 같은 계정 권한 · 같은 호출 한도(서비스별 하루 1,000회, MCP와 합산)를 사용합니다. 연동은 LOGGER 요금에 포함되어 있어 별도 과금이 없습니다.\n핵심 요약\nAPI 문서는 https://logger.co.kr/apis/docs/ , OpenAPI 명세는 /apis/openapi.yaml 입니다. ChatGPT Actions · Postman 등에서 주소로 직접 가져올 수 있습니다.\nPOST /apis/v1/auth/token 으로 조회 전용 토큰을 발급받고, 모든 요청의 Authorization 헤더에 Bearer 토큰을 넣습니다. 토큰은 12시간 뒤 만료됩니다.\n리포트는 목록(/v1/reports) → 스키마(/v1/reports/{code}/schema) → 데이터(/v1/reports/{code}/data) 순서로 조회합니다.\n하루 1,000회 한도 안에서 정해진 지표를 주기적으로 조회하도록 설계하고, 대량 자료는 리포트 통합 다운로드, 원본 실시간 공급은 구축형 사업으로 검토합니다.\n목차\nREST API와 MCP, 언제 무엇을 쓰는가\n인증: 토큰 발급과 보관\n주요 엔드포인트와 리포트 조회 순서\n호출 한도와 응답 코드\n사내 대시보드 연동 설계\n\n## REST API와 MCP, 언제 무엇을 쓰는가\n\nLOGGER는 리포트 데이터를 콘솔 화면 밖에서 조회하는 두 가지 방법을 제공합니다. MCP는 Claude · ChatGPT 같은 AI 서비스에 LOGGER를 연결해 대화로 분석하는 방법이고, REST API는 개발자가 자사 시스템에서 데이터를 불러오는 방법입니다. 두 방법은 같은 조회 기능과 같은 계정 권한을 사용하므로, 목적에 따라 고르면 됩니다.\n목적별 방법 선택 기준(LOGGER 매뉴얼 「MCP/API 서비스 개요」 기준) 목적 권장 방법 이유\n여러 리포트를 함께 질문하고 표와 해석을 받으려는 경우 MCP(Claude · ChatGPT) AI가 리포트를 골라 조회하고 문장으로 정리합니다.\n사내 시스템 · BI 도구에서 정기적으로 수치를 불러오려는 경우 REST API OpenAPI 명세로 클라이언트를 생성해 같은 형식으로 반복 조회합니다.\n터미널에서 AI 코딩 도구로 분석하려는 경우 MCP(Claude Code) 명령 한 줄로 연결하고 스크립트 작업과 함께 씁니다.\n원본 행동 데이터를 사내 AI · BI에 실시간으로 공급하려는 경우 구축형(On-Premise) 실시간 데이터 파이프라인 리포트 조회 API가 아니라 별도 구축 사업으로 진행합니다.\n\n문서는 두 가지입니다\n공개 명세(/apis/openapi.yaml)는 조회 계열 경로를 담고 있습니다. 설정 변경 경로를 포함한 전체 명세는 로그인 후 /apis/docs/full/ 에서 확인할 수 있습니다. API 문서(Swagger)에서는 오른쪽 위 Authorize에 토큰을 입력하고 Try it out으로 호출을 시험합니다.\n\n## 인증: 토큰 발급과 보관\n\n1 토큰 발급 POST https://logger.co.kr/apis/v1/auth/token 에 loginId, password, scope(read)를 JSON으로 전송해 토큰(lgr_로 시작)을 발급받습니다. 연동용 토큰은 조회 전용입니다.\n\n2 헤더 설정 이후 모든 요청의 Authorization 헤더에 「Bearer <발급받은 토큰>」을 입력합니다.\n\n3 서비스 확인 GET /apis/v1/services 로 조회할 수 있는 서비스와 서비스 번호(loggerId)를 확인합니다. 이 번호를 이후 리포트 조회의 기준으로 씁니다.\n\n4 만료 처리 토큰은 로그인 세션 토큰이므로 12시간 뒤 만료됩니다. 배치 작업은 실행할 때마다 토큰을 새로 발급하도록 구성합니다.\n\n토큰은 비밀번호와 같은 수준으로 보관합니다\n토큰과 로그인 정보는 화면, 문서, 채팅, 소스 저장소에 노출하지 마십시오. 사내 비밀 값 저장소에 보관하고, 배치 서버에서만 읽도록 권한을 제한합니다. 설정 변경은 연동용 토큰이 아니라 LOGGER 콘솔에서 합니다.\n\n## 주요 엔드포인트와 리포트 조회 순서\n\nLOGGER REST API 주요 경로(LOGGER 매뉴얼 「REST API 사용 방법」에 수록된 경로, 기본 주소 https://logger.co.kr/apis) 메서드 · 경로 용도 비고\nPOST /v1/auth/token 토큰 발급 loginId · password · scope(read), 12시간 뒤 만료\nGET /v1/services 조회 가능한 서비스(loggerId) 목록 서비스를 지정하지 않는 호출이라 계정별로 집계\nGET /v1/reports 리포트 코드 목록 어떤 리포트를 조회할지 정합니다\nGET /v1/reports/{code}/schema 차원 · 지표 · 필터 정의 ?include=values 로 필터 값 형태 확인\nGET /v1/reports/{code}/data 리포트 실데이터 조회 loggerId · ps · pe · groupBy · filter 등\nGET /v1/usage?loggerId= 오늘 남은 호출 수 확인 응답 헤더 X-RateLimit-Remaining 으로도 확인\nGET /v1/skills · /v1/skills/{id} 사용 절차서 목록 · 본문 REST 규약은 id가 api-guide인 절차서\n\n리포트 데이터를 조회하는 순서 단계 1\n토큰 발급\n/v1/auth/token\n\n단계 2\n서비스 확인\n/v1/services\n\n단계 3\n리포트 코드\n/v1/reports\n\n단계 4\n스키마 확인\n/schema\n\n단계 5\n데이터 조회\n/data\n\ngroupBy는 한 요청에 하나만 지정합니다. 두 기준을 함께 보려면 한 기준으로 나누고 다른 기준은 filter로 좁혀 여러 번 조회합니다. filter 값에는 화면에 표시되는 이름이 아니라 응답 rows의 value를 그대로 입력해야 0건 응답을 피할 수 있습니다. 응답은 성공이면 { ok: true, data, meta }, 실패면 { ok: false, error: { code, message, http, ref } } 형식이며, 4xx 오류는 message에 수정할 내용이 구체적으로 표시됩니다. 5xx 오류는 참조 코드(ref)만 제공하므로 문의할 때 함께 전달합니다.\n\n## 호출 한도와 응답 코드\n\nREST API 호출 한도(LOGGER 매뉴얼 기준) 항목 내용\n한도 서비스(loggerId)별 하루 1,000회. MCP와 합산하며, 같은 서비스를 조회하는 모든 계정의 호출을 합산합니다.\n초기화 한국 시각 자정\n남은 횟수 확인 GET /v1/usage?loggerId= 또는 응답 헤더 X-RateLimit-Limit · X-RateLimit-Remaining\n초과 시 429 RATE_LIMITED와 Retry-After 헤더가 반환됩니다.\n집계하지 않는 호출 토큰 발급, 절차서 조회, 매뉴얼 조회\n\n429 응답은 재시도하지 않습니다\n한도를 초과한 뒤 같은 요청을 반복하면 결과가 달라지지 않습니다. 배치 작업은 429를 받으면 그날 작업을 멈추고 다음 날 다시 실행하도록 구성합니다. 이 한도는 API를 대량 데이터 추출 용도로 쓰지 못하게 하기 위한 정책입니다. 많은 자료가 필요하면 리포트 화면의 다운로드와 리포트 통합 다운로드를 이용하십시오.\n\n## 사내 대시보드 연동 설계\n\n사내 대시보드에 LOGGER 지표를 표시할 때는 필요한 지표를 먼저 정하고, 그 지표에 해당하는 리포트를 정해진 주기로 조회하는 구조가 안정적입니다. 리포트 수와 조회 주기로 하루 호출 수를 미리 계산해 두면 한도 안에서 운영할 수 있습니다.\n1 지표 정의 대시보드에 표시할 지표(방문수 · 전환수 · 매출 · 채널별 유입 등)와 기준 기간을 문서로 정합니다.\n\n2 리포트 코드와 스키마 고정 지표마다 리포트 코드, groupBy, filter 값을 정해 설정 파일로 관리합니다. 스키마는 정기적으로 다시 확인합니다.\n\n3 주기 조회 전일 집계값을 하루 한 번 조회하는 배치를 기본으로 합니다. 같은 기간을 여러 번 조회하지 않도록 결과를 사내 저장소에 보관합니다.\n\n4 표시와 점검 대시보드는 사내 저장소의 값을 읽어 표시합니다. 배치 마지막 단계에서 /v1/usage로 남은 호출 수를 기록해 한도 사용량을 점검합니다.\n\n하루 호출 수 계산 예시(예시이며 실제 리포트 수는 사내 요구에 따라 달라집니다) 구성 계산 하루 호출 수(예시)\n토큰 발급 집계하지 않음 0회\n리포트 8종 전일값 조회 8종 × 1회 8회\n채널별 · 디바이스별 분할 조회 2종 × 기준 5개 10회\n남은 횟수 확인 1회 1회\n합계 약 19회(한도 1,000회 대비 여유)\n\n원본 데이터가 필요하면 구축형을 검토합니다\nREST API는 집계된 리포트 값을 조회하는 용도입니다. 방문자 행동 원본 데이터를 사내 데이터 웨어하우스나 AI 시스템에 실시간으로 공급하려면 구축형(On-Premise) 실시간 데이터 파이프라인을 별도 구축 사업으로 진행합니다. 범위와 일정은 도입 문의(/contact)에서 상담하실 수 있습니다.\n\n## 자주 묻는 질문\n\n### Q. REST API 토큰은 얼마 동안 유효한가요?\n\n로그인 세션 토큰이므로 12시간 뒤 만료됩니다. 만료되면 POST /apis/v1/auth/token 으로 다시 발급합니다. 토큰 발급 호출은 하루 호출 한도에 집계하지 않습니다.\n\n### Q. REST API로 설정을 바꿀 수 있나요?\n\n연동용 토큰은 조회 전용입니다. 설정 변경은 LOGGER 콘솔에서 하며, AI 서비스에서 설정을 바꾸려면 MCP를 읽기 · 쓰기 권한으로 연결합니다.\n\n### Q. Postman이나 ChatGPT Actions에서 바로 쓸 수 있나요?\n\n가능합니다. OpenAPI 3.1 명세 주소(/apis/openapi.yaml)를 가져오면 경로와 파라미터가 자동으로 구성됩니다. 토큰은 Bearer 인증으로 입력합니다.\n\n### Q. 하루 1,000회보다 많이 호출해야 하면 어떻게 하나요?\n\n한도는 대량 데이터 추출을 막기 위한 정책이므로 늘리지 않습니다. 조회 주기와 범위를 조정하고, 많은 자료는 리포트 통합 다운로드를 이용하십시오. 원본 데이터의 실시간 공급이 필요하면 구축형 실시간 데이터 파이프라인을 상담하실 수 있습니다.\n\n### Q. API로 조회한 값과 콘솔 화면의 값이 다르면 무엇을 확인하나요?\n\n조회 기간(ps · pe), 서비스 번호(loggerId), filter 값이 화면 조건과 같은지 확인합니다. filter에는 화면 표시 이름이 아니라 응답 rows의 value를 넣어야 합니다.\n\nFAQ 100개 전체 보기\n\n## 함께 보면 좋은 지식 문서\n\n고급 · MCP/API\nClaude · ChatGPT로 웹사이트 데이터 분석하기\n활용 사례\n행동 로그를 데이터 웨어하우스에 적재하기\n활용 사례\nREST API로 마케팅 자동화 연동하기\n\n## 참고 자료\n\nLOGGER 매뉴얼: REST API 사용 방법\nLOGGER 매뉴얼: MCP/API 서비스 개요\nLOGGER 매뉴얼: 활용 사례 3 (매일 아침 조회 후 Slack 알림)\n비즈스프링 블로그: 자체 구축과 솔루션 도입의 비용을 비교하면\n비즈스프링 블로그: 웹로그에서 볼 수 있는 것과 볼 수 없는 것\nLOGGER로 직접 확인해 보십시오\n14일 무료체험을 제공하며, 기본 스크립트 설치를 무상으로 대행합니다.\n14일 무료체험 시작하기 요금 보기 도입 문의\n\n출처: https://logger.co.kr/files/knowledge/rest-api-integration.html",
  "related_slugs": [],
  "keywords": [],
  "faq": [
    {
      "a": "로그인 세션 토큰이므로 12시간 뒤 만료됩니다. 만료되면 POST /apis/v1/auth/token 으로 다시 발급합니다. 토큰 발급 호출은 하루 호출 한도에 집계하지 않습니다.",
      "q": "REST API 토큰은 얼마 동안 유효한가요?"
    },
    {
      "a": "연동용 토큰은 조회 전용입니다. 설정 변경은 LOGGER 콘솔에서 하며, AI 서비스에서 설정을 바꾸려면 MCP를 읽기 · 쓰기 권한으로 연결합니다.",
      "q": "REST API로 설정을 바꿀 수 있나요?"
    },
    {
      "a": "가능합니다. OpenAPI 3.1 명세 주소(/apis/openapi.yaml)를 가져오면 경로와 파라미터가 자동으로 구성됩니다. 토큰은 Bearer 인증으로 입력합니다.",
      "q": "Postman이나 ChatGPT Actions에서 바로 쓸 수 있나요?"
    },
    {
      "a": "한도는 대량 데이터 추출을 막기 위한 정책이므로 늘리지 않습니다. 조회 주기와 범위를 조정하고, 많은 자료는 리포트 통합 다운로드를 이용하십시오. 원본 데이터의 실시간 공급이 필요하면 구축형 실시간 데이터 파이프라인을 상담하실 수 있습니다.",
      "q": "하루 1,000회보다 많이 호출해야 하면 어떻게 하나요?"
    },
    {
      "a": "조회 기간(ps · pe), 서비스 번호(loggerId), filter 값이 화면 조건과 같은지 확인합니다. filter에는 화면 표시 이름이 아니라 응답 rows의 value를 넣어야 합니다.",
      "q": "API로 조회한 값과 콘솔 화면의 값이 다르면 무엇을 확인하나요?"
    }
  ],
  "jsonld": null,
  "image_url": null,
  "caption": null,
  "width": null,
  "height": null,
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "solution_slug": null,
  "source_id": "https://logger.co.kr/files/knowledge/rest-api-integration.html",
  "created_at": "2026-11-17T19:57:17.434643+00:00",
  "updated_at": "2026-11-17T19:57:17.434643+00:00",
  "backlinks": [
    "screenshot/logger-co-kr"
  ],
  "html_url": "https://bizspring.ai/kb/ref/web/logger-co-kr/logger-rest-api-연동-가이드-토큰-인증-주요-엔드포인트-호출-한도-사내-대시보드-설계-logger-bizspring",
  "markdown_url": "https://bizspring.ai/kb/ref/web/logger-co-kr/logger-rest-api-연동-가이드-토큰-인증-주요-엔드포인트-호출-한도-사내-대시보드-설계-logger-bizspring.md"
}