{
  "slug": "ref/web/logger-co-kr/rest-api-사용-방법-logger-사용자-매뉴얼",
  "doc_type": "ref",
  "title": "REST API 사용 방법 — LOGGER 사용자 매뉴얼",
  "title_en": null,
  "one_liner": "REST API 사용 방법 — LOGGER 사용자 매뉴얼 본문 바로가기 LOGGER 도움말 LOGGER 사용자 매뉴얼 — 리포트·기능 설명, 설치 및 이용방법, 용어와 계산 기준 LOGGER 방문 동적 매뉴얼 보기 PDF 매뉴얼 콘솔 열기 REST API 사용 방법 분류:",
  "summary_bullets": [
    "LOGGER 로그인 계정이 있으면 누구나 REST API로 리포트 데이터를 HTTP로 불러올 수 있으며, 설정 변경은 콘솔에서만 가능합니다.",
    "API 문서는 /apis/docs/(Swagger)에서, 전체 명세(설정 변경 포함)는 로그인 후 /apis/docs/full/에서 확인할 수 있습니다.",
    "POST /apis/v1/auth/token으로 12시간 유효한 토큰을 발급받아 Authorization 헤더에 Bearer로 포함해 요청합니다.",
    "리포트 조회는 /v1/reports → /v1/reports/{code}/schema → /v1/reports/{code}/data 순서로 진행하며 groupBy는 한 번에 하나만 지정합니다.",
    "서비스별 하루 호출 한도는 1,000회(MCP와 합산)이며 초과 시 429 오류가 반환되므로 재시도 대신 자정 이후 호출해야 합니다."
  ],
  "body_md": "REST API 사용 방법 — LOGGER 사용자 매뉴얼\n\n본문 바로가기\n\nLOGGER 도움말 LOGGER 사용자 매뉴얼 — 리포트·기능 설명, 설치 및 이용방법, 용어와 계산 기준\n\nLOGGER 방문 동적 매뉴얼 보기 PDF 매뉴얼 콘솔 열기\n\n# REST API 사용 방법\n\n분류: MCP/API 서비스 최종 수정일: 2026-10-31 콘솔 화면: MCP/API 서비스\n\n## 해당 제품(서비스)\n\nLOGGER 로그인 계정이 있는 모든 사용자에게 제공합니다. 연동용 토큰은 조회 전용이며, 설정 변경은 LOGGER 콘솔에서 합니다.\n\n## REST API 정의\n\nREST API는 개발자가 자사 시스템이나 BI 도구에서 LOGGER 리포트 데이터를 HTTP로 불러오는 방법입니다. 계약은 OpenAPI 3.1 명세로 제공하며 MCP와 같은 조회 기능, 같은 계정 권한을 사용합니다.\n\n## 문서와 명세\n\nAPI 문서(Swagger): 접속한 LOGGER 서버의 /apis/docs/에서 우측 상단 Authorize에 토큰을 입력하고 Try it out으로 시험합니다.\nOpenAPI 명세: /apis/openapi.yaml(OpenAPI 3.1)입니다. ChatGPT Actions, Postman, Make 등에서 주소로 직접 가져올 수 있습니다.\n공개 명세는 조회 계열 경로입니다. 설정 변경 경로를 포함한 전체 명세는 로그인 후 /apis/docs/full/에서 확인할 수 있습니다.\n\n## 인증\n\nPOST /apis/v1/auth/token에 loginId, password, scope(read)를 전송하여 토큰(lgr_…)을 발급받습니다. 로그인 세션 토큰이므로 12시간 뒤 만료되며, 만료되면 다시 발급합니다.\n이후 모든 요청의 Authorization 헤더에 Bearer <토큰>을 입력합니다.\nGET /apis/v1/services로 조회 가능한 서비스(loggerId) 목록을 확인합니다.\n\ncurl -X POST https://logger.co.kr/apis/v1/auth/token \\\n-H \"Content-Type: application/json\" \\\n-d '{\"loginId\":\"<로그인 ID>\",\"password\":\"<비밀번호>\",\"scope\":\"read\"}'\ncurl https://logger.co.kr/apis/v1/services \\\n-H \"Authorization: Bearer <발급받은 토큰>\"\n토큰은 비밀번호와 같은 수준으로 보관하고 화면, 문서, 채팅에 노출하지 마십시오.\n\n## 리포트 조회 순서\n\nGET /v1/reports로 리포트 코드를 확인합니다.\nGET /v1/reports/{code}/schema로 차원, 지표, 필터를 확인합니다(?include=values로 필터 값 형태를 확인할 수 있습니다).\nGET /v1/reports/{code}/data로 실제 데이터를 조회합니다(loggerId, ps, pe, groupBy, filter 등).\n\ngroupBy는 한 요청에 하나만 지정합니다. 두 기준을 함께 보려면 한 기준으로 나누고 다른 기준은 filter로 좁혀 여러 번 조회합니다.\n\nfilter 값에는 화면에 표시되는 이름이 아니라 응답 rows의 value를 그대로 입력합니다.\n\n## 응답과 오류\n\n구분 형식\n호출 한도 서비스(loggerId)별 하루 1,000회입니다(MCP와 합산, 같은 서비스를 조회하는 모든 계정의 호출 합산, 한국 시각 자정 초기화). 남은 횟수는 GET /v1/usage?loggerId=로 확인합니다. 초과하면 429 RATE_LIMITED와 Retry-After가 반환되고, 응답 헤더 X-RateLimit-Remaining으로도 남은 횟수를 확인할 수 있습니다. 데이터 대량 내보내기 방지가 목적이며 절차서, 매뉴얼 조회, 토큰 발급은 집계하지 않습니다.\n성공 { ok: true, data, meta }\n실패 { ok: false, error: { code, message, http, ref? } }\n4xx message에 수정할 내용이 구체적으로 표시됩니다.\n5xx 내부 구조는 공개하지 않고 ref(참조 코드)만 제공합니다. 문의할 때 ref를 알려 주십시오.\n\n## 사용 절차서\n\n조회 순서, 드릴다운, 회원 분석, 설정 변경 절차를 정리한 절차서를 API로도 받을 수 있습니다. 목록은 GET /v1/skills, 본문은 GET /v1/skills/{id}입니다. REST 인증과 응답 규약은 id가 api-guide인 절차서에 있습니다.\n\n## 유의사항\n\n토큰은 비밀번호와 같은 수준으로 보관하고 화면, 문서, 채팅에 노출하지 마십시오.\n하루 호출 한도는 서비스별 1,000회(MCP와 API 합산)입니다. 한도를 초과하면 429 응답이 반환되므로 재시도하지 말고 자정 이후에 호출하십시오.\n\n이 문서의 Markdown: /console/manual-stt/console-integrations-api.md.txt\n\n## 이 페이지 목차\n\n해당 제품(서비스)\nREST API 정의\n문서와 명세\n인증\n리포트 조회 순서\n응답과 오류\n사용 절차서\n유의사항\n\n출처: https://logger.co.kr/console/manual-stt/console-integrations-api.html",
  "related_slugs": [],
  "keywords": [],
  "faq": [
    {
      "a": "POST /apis/v1/auth/token에 loginId, password, scope(read)를 전송하면 lgr_로 시작하는 토큰을 받습니다. 이 토큰은 로그인 세션 토큰이라 12시간 뒤 만료되며, 만료 시 다시 발급받아야 합니다.",
      "q": "REST API 토큰은 어떻게 발급받나요?"
    },
    {
      "a": "GET /v1/reports로 리포트 코드를 먼저 확인하고, /v1/reports/{code}/schema로 차원·지표·필터를 확인한 뒤 /v1/reports/{code}/data로 실제 데이터를 조회합니다.",
      "q": "조회 가능한 리포트 목록은 어디서 확인하나요?"
    },
    {
      "a": "서비스(loggerId)별로 하루 1,000회이며 MCP와 합산되고 같은 서비스를 조회하는 모든 계정의 호출이 합산됩니다. 한국 시각 자정에 초기화되고, 남은 횟수는 GET /v1/usage?loggerId=로 확인할 수 있습니다.",
      "q": "하루에 API를 몇 번까지 호출할 수 있나요?"
    },
    {
      "a": "429 RATE_LIMITED 오류와 Retry-After 헤더가 반환되며, 응답 헤더 X-RateLimit-Remaining으로도 남은 횟수를 확인할 수 있습니다. 재시도하지 말고 자정 이후에 다시 호출해야 합니다.",
      "q": "호출 한도를 초과하면 어떻게 되나요?"
    },
    {
      "a": "아니요, filter 값에는 화면 표시 이름이 아니라 응답 rows의 value를 그대로 입력해야 합니다.",
      "q": "필터 값은 화면에 보이는 이름을 그대로 넣으면 되나요?"
    }
  ],
  "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/console/manual-stt/console-integrations-api.html",
  "created_at": "2026-11-17T20:06:47.738296+00:00",
  "updated_at": "2026-11-17T20:06:47.738296+00:00",
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/web/logger-co-kr/rest-api-사용-방법-logger-사용자-매뉴얼",
  "markdown_url": "https://bizspring.ai/kb/ref/web/logger-co-kr/rest-api-사용-방법-logger-사용자-매뉴얼.md"
}