Approval

승인 워크플로우를 관리하는 API입니다. 요청 생성, 승인/거절 결정, 만료 처리 등 상태 머신 기반 승인 프로세스를 제공합니다.

엔드포인트

POST /api/v1/approvals/

설명: 새 승인 요청을 생성합니다. (HTTP 201)

요청 본문:

필드	타입	필수	설명
resource_type	string	Y	리소스 유형
resource_id	string	Y	리소스 ID
reason	string	N	요청 사유

GET /api/v1/approvals/

설명: 모든 승인 요청 목록을 반환합니다. 상태 필터를 지원합니다.

GET /api/v1/approvals/my

설명: 본인이 생성한 승인 요청 목록을 반환합니다.

GET /api/v1/approvals/{request_id}

설명: 특정 승인 요청의 상세 정보를 반환합니다.

POST /api/v1/approvals/{request_id}/decide

설명: 승인 요청을 승인 또는 거절합니다.

POST /api/v1/approvals/{request_id}/cancel

설명: 승인 요청을 취소합니다.

POST /api/v1/approvals/expire

설명: 만료된 대기 중 요청을 일괄 만료 처리합니다.

인증

JWT Bearer 토큰이 필요합니다.

에러 코드

코드	설명
400	이미 처리된 요청에 대한 중복 결정
404	승인 요청을 찾을 수 없음
500	승인 처리 실패