Audit
OpenSearch 기반 감사 로그를 검색하고 통계를 조회하는 API입니다. AuditMiddleware가 기록한 모든 API 요청 로그를 분석할 수 있습니다.
엔드포인트
GET /api/v1/audit/logs
설명: 감사 로그를 검색합니다. 다양한 필터 조건을 지원합니다.
쿼리 파라미터:
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| user | string | N | 사용자 필터 |
| action | string | N | 액션 필터 |
| start_date | string | N | 시작 일시 (ISO 8601) |
| end_date | string | N | 종료 일시 (ISO 8601) |
| page | int | N | 페이지 번호 |
| size | int | N | 페이지 크기 |
GET /api/v1/audit/stats
설명: 감사 로그 통계를 반환합니다. 기간별 요청 수, 사용자별 분포 등을 제공합니다.
GET /api/v1/audit/health
설명: OpenSearch 감사 로그 저장소의 연결 상태를 확인합니다.
인증
JWT Bearer 토큰이 필요합니다.
에러 코드
| 코드 | 설명 |
|---|---|
| 400 | 잘못된 날짜 형식 또는 필터 조건 |
| 500 | OpenSearch 연결 실패 |