API 로그 요약

최근 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이 콘솔에서 로그인한 토큰으로만 조회할 수 있다.

최근 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이 콘솔에서 로그인한 토큰으로만 조회할 수 있다.

Authorization

bearer

AuthorizationBearer <token>

userToken(계정 스코프) 또는 storeToken(스토어 스코프)

In: header

Response Body

`application/json`

curl -X GET "https://example.com/v1/api-logs/summary"

{  "meta": {    "status": 0,    "code": "OK",    "message": "string",    "isSuccess": true  },  "data": {    "windowHours": -9007199254740991,    "total": 0,    "errors": 0,    "serverErrors": 0  },  "error": null}

Authorization

Response Body

200application/json

401

403

`application/json`