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