Audit Report
감사 보고서를 생성, 조회, 다운로드하는 API입니다. 기간별 감사 로그를 집계하여 정형화된 보고서로 생성합니다.
엔드포인트
POST /api/v1/audit-reports
설명: 새 감사 보고서를 생성합니다. (HTTP 201) 보고서는 백그라운드에서 비동기로 생성됩니다.
요청 본문:
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| title | string | Y | 보고서 제목 |
| start_date | string | Y | 시작 일시 |
| end_date | string | Y | 종료 일시 |
| report_type | string | N | 보고서 유형 |
GET /api/v1/audit-reports
설명: 생성된 감사 보고서 목록을 반환합니다.
GET /api/v1/audit-reports/{report_id}
설명: 특정 감사 보고서의 상세 정보를 반환합니다.
GET /api/v1/audit-reports/{report_id}/download
설명: 감사 보고서 파일을 다운로드합니다.
DELETE /api/v1/audit-reports/{report_id}
설명: 감사 보고서를 삭제합니다.
인증
JWT Bearer 토큰이 필요합니다.
에러 코드
| 코드 | 설명 |
|---|---|
| 400 | 잘못된 날짜 범위 또는 보고서 유형 |
| 404 | 보고서를 찾을 수 없음 |
| 500 | 보고서 생성 또는 다운로드 실패 |