API 로그
상점으로 들어온 관리 API 요청 기록 조회
상점으로 들어온 관리 API 요청을 7일간 기록합니다. 연동 앱이나 액세스 토큰이 무엇을 보냈고 어떤 응답을 받았는지 확인합니다.
상점 플랫폼에서 개발자 › 모니터링 › API 로그로 이동합니다(소유자·관리자).
기록 항목
| 항목 | 내용 |
|---|---|
| 요청 일시 | 요청을 받은 시각 |
| 메서드·경로 | 쿼리 포함. 민감한 쿼리 값은 가림 |
| 상태 코드·처리 시간 | 응답 HTTP 상태 코드, 요청부터 응답까지(ms) |
| 호출 주체 | 상점 플랫폼 사용자(USER)·액세스 토큰(PAT)·앱(CLIENT, CLI·원격 MCP·연동 앱의 로그인 토큰)과 요청 당시 이름 |
| 추적 ID | 에러 응답의 error.traceId와 같은 값 |
| 에러 | 4xx·5xx의 에러 코드와 메시지 |
조회와 필터
상점 플랫폼은 기간·호출 주체·응답 코드·경로로 거릅니다. API는 GET /v1/api-logs이고 호출 주체 유형을 여러 개 줄 수 있습니다.
| 쿼리 | 설명 |
|---|---|
traceId | 추적 ID 정확히 일치. 에러 응답의 error.traceId로 그 요청 한 건을 찾음 |
q | 경로 검색어. 리소스 ID로 그 리소스를 다룬 요청을 찾음 |
const logs = await api.apiLogs.list({ traceId: err.traceId });요청 본문은 저장하지 않으므로 어떤 요청이 어떤 에러로 끝났는지 확인하는 용도입니다. 개발자 › 개요의 **연동 API 호출 (24시간)**은 액세스 토큰과 앱의 호출만 셉니다.
전송 기록과 오가기
| 가진 값 | 다음 조회 |
|---|---|
에러 응답의 error.traceId | API 로그 traceId — 그 요청 한 건 |
웹훅 전송 기록의 resource.id | API 로그 q — 그 리소스를 다룬 요청들 |
| API 로그에서 본 리소스 ID | 웹훅 전송 기록 resourceId — 그 리소스로 나간 이벤트 |
기록 대상
상점이 확인된 /v1/** 요청만 기록합니다. /.well-known/*, API 로그 조회 자체, 인증·권한 단계에서 거부된
요청(401, 스코프 부족 403), 스토어프론트 API 요청은 기록하지 않습니다.
저장하지 않는 정보
Authorization 헤더·쿠키·요청 본문·구매자 개인정보는 저장하지 않습니다. 쿼리는 키를 남기고 자격 증명(token·secret·code·
password 등), 개인정보(email·phone·name·address 등), 검색어(keyword·search·q 등) 값을 ***로 가립니다.
GET /v1/orders?keyword=***&page=1