API 로그 목록
이 스토어로 들어온 관리 API 요청 기록을 최신순으로 반환한다. 커서 페이지네이션이며, 다음 페이지는 응답의 `nextCursor`를 `cursor`로 넘겨 조회한다. `status=error`는 4xx·5xx 전체, `q`는 경로(쿼리 포함, 마스킹 후 값) 부분 일치(대소문자 무시), `from`은 포함·`to`는 미포함이다. 필터를 바꾸면 커서를 버리고 처음부터 조회한다. 기록 대상은 이 스토어로 인증된 관리 API(`/v1/**`) 요청이다. OAuth 프로토콜 표면(`/v1/oauth2/*`, `/.well-known/*`)과 API 로그 조회 자체(`/v1/api-logs`)는 기록하지 않는다. 인증 단계에서 거부된 요청(토큰이 없거나 유효하지 않은 401, 토큰 스코프 부족 403)은 스토어를 확정하기 전이라 기록되지 않는다. Authorization·쿠키 헤더와 요청 본문은 저장하지 않고, 민감한 쿼리 값(token·secret·code·password·email·phone·이름·검색어 등)은 `***`로 가린다. 기록은 응답 후 비동기로 쌓여 수 초 늦게 보일 수 있다. 보관 기간은 7일이며 조회도 최근 7일로 한정된다. OWNER/ADMIN이 콘솔에서 로그인한 토큰으로만 조회할 수 있다.
이 스토어로 들어온 관리 API 요청 기록을 최신순으로 반환한다. 커서 페이지네이션이며, 다음 페이지는 응답의 nextCursor를 cursor로 넘겨 조회한다. status=error는 4xx·5xx 전체, q는 경로(쿼리 포함, 마스킹 후 값) 부분 일치(대소문자 무시), from은 포함·to는 미포함이다. 필터를 바꾸면 커서를 버리고 처음부터 조회한다.
기록 대상은 이 스토어로 인증된 관리 API(/v1/**) 요청이다. OAuth 프로토콜 표면(/v1/oauth2/*, /.well-known/*)과 API 로그 조회 자체(/v1/api-logs)는 기록하지 않는다. 인증 단계에서 거부된 요청(토큰이 없거나 유효하지 않은 401, 토큰 스코프 부족 403)은 스토어를 확정하기 전이라 기록되지 않는다. Authorization·쿠키 헤더와 요청 본문은 저장하지 않고, 민감한 쿼리 값(token·secret·code·password·email·phone·이름·검색어 등)은 ***로 가린다. 기록은 응답 후 비동기로 쌓여 수 초 늦게 보일 수 있다. 보관 기간은 7일이며 조회도 최근 7일로 한정된다. OWNER/ADMIN이 콘솔에서 로그인한 토큰으로만 조회할 수 있다.
Authorization
bearer userToken(계정 스코프) 또는 storeToken(스토어 스코프)
In: header
Query Parameters
조회 시작 일시 (ISO 8601, 포함). 보관 기간은 7일이다
조회 종료 일시 (ISO 8601, 미포함)
호출 주체 유형 필터. 여러 개는 쉼표로 구분한다 (예: PAT,CLIENT). 파싱 결과는 배열로 정규화된다
호출 주체 ID 필터
응답 상태 필터. error는 4xx·5xx 전체
Value in
- "2xx"
- "3xx"
- "4xx"
- "5xx"
- "error"
경로 부분 일치 검색어
이전 응답의 nextCursor. 생략하면 가장 최신부터
최대 건수 (1~100, 기본 50)
1 <= value <= 100Response Body
application/json
curl -X GET "https://example.com/v1/api-logs"{ "meta": { "status": 0, "code": "OK", "message": "string", "isSuccess": true }, "data": { "items": [ { "logId": "string", "occurredAt": "string", "method": "string", "path": "string", "statusCode": -9007199254740991, "latencyMs": 0, "principal": { "type": "USER", "id": "string", "name": "string" }, "traceId": "string", "error": { "code": "string", "message": "string" } } ], "nextCursor": "string" }, "error": null}유입별 방문 분석 GET
유입 채널·소스·캠페인·기기별 세션과 구매를 돌려준다. 세션의 유입은 그 세션 첫 페이지뷰의 utm·리퍼러다. 스코프 `analytics:r`. - 날짜는 Asia/Seoul 기준이며 `from`·`to` 모두 포함한다. 최대 92일. - 스토어프런트가 `@sayren/storefront-sdk`로 수집한 이벤트를 주기적으로 집계한 값이다. 오늘 값은 `lastComputedAt` 시점까지 반영된다. - 봇·자동화 브라우저의 세션은 빠진다. 테스트 결제(샌드박스 결제)로 만든 구매는 기본 제외이고 `includeTest=true`면 포함한다.
API 로그 요약 GET
최근 24시간(`windowHours`)의 연동 요청 수(`total`)와 그중 4xx·5xx 응답 수(`errors`), 5xx 응답 수(`serverErrors`). 연동 트래픽(호출 주체 `PAT`·`CLIENT`)만 집계하고 콘솔 사용자(`USER`) 요청은 제외한다. 개요 화면 지표용이다. 기록 대상은 이 스토어로 인증된 관리 API(`/v1/**`) 요청이다. OAuth 프로토콜 표면(`/v1/oauth2/*`, `/.well-known/*`)과 API 로그 조회 자체(`/v1/api-logs`)는 기록하지 않는다. 인증 단계에서 거부된 요청(토큰이 없거나 유효하지 않은 401, 토큰 스코프 부족 403)은 스토어를 확정하기 전이라 기록되지 않는다. Authorization·쿠키 헤더와 요청 본문은 저장하지 않고, 민감한 쿼리 값(token·secret·code·password·email·phone·이름·검색어 등)은 `***`로 가린다. 기록은 응답 후 비동기로 쌓여 수 초 늦게 보일 수 있다. 보관 기간은 7일이며 조회도 최근 7일로 한정된다. OWNER/ADMIN이 콘솔에서 로그인한 토큰으로만 조회할 수 있다.