REST API 설계

REST API 설계

HTTP 메서드	URI	설명	요청 바디 / 응답 예시
POST	/documents	새 문서 생성	{ title, description, author }
GET	/documents/{documentId}	문서 상세 조회	문서 상세 정보 + 첨부파일 목록
PUT	/documents/{documentId}	문서 수정	{ title, description, status }
DELETE	/documents/{documentId}	문서 삭제 (상태 변경)	상태를 DELETED로 변경
POST	/documents/{documentId}/files	문서에 파일 첨부	Multipart/form-data (file)
GET	/documents/{documentId}/files/{fileId}	특정 파일 상세 조회	파일 메타정보 + 현재 버전 정보
DELETE	/documents/{documentId}/files/{fileId}	파일 삭제 (상태 변경)	상태를 비활성화 등
POST	/files/{fileId}/versions	파일 버전 업로드	Multipart/form-data (file), changeReason(optional)
GET	/files/{fileId}/versions/{versionNo}	특정 버전 다운로드	파일 바이너리 또는 메타정보
PUT	/files/{fileId}/versions/{versionNo}/restore	특정 버전 복원	이전 버전을 현재 버전으로 설정