API 설계 과정에서부터 성능 고민을 하다

오랜만에 프로젝트를 하며 고민한 내용을 다룬 글을 작성하였습니다.

Spring AI에 컨트리뷰트 경험을 제공해줬던 캡스톤 프로젝트를, 부트캠프에서 다시 처음부터 설계해보는 과정을 진행하고 있습니다.

바로 개발을 시작하기보다는 API와 DB 구조를 먼저 설계한 뒤 개발을 하기로 하였는데요, 그래서 그런지 API 설계를 하는 과정에서도 생각보다 많은 것을 배울 수 있었습니다.

고민한 점은 다음과 같았습니다.

- POST 응답 시 id 반환 vs 최대한 많은 데이터를 응답

- 파일 (사진) 업로드 성능 개선 고민 - PresignedURL을 이용한 이유

- AI를 호출하여 데이터를 분석/생성할 때 GET or POST에 대한 고민

- 조회 과정에서의 페이지네이션 방식으로 커서 기반 페이지네이션을 적용한 이유

- 삭제 처리를 soft delete로 한 이유

- 취소 요청 API 설계 및 Rate Limit에 대한 고민

API를 설계를 하며 성능적으로 고민해보는 과정에서 그동안 API를 설계할 때는 단순 구현만 생각하고 있었음을 알게 되었습니다. 다음 글로는 DB 설계를 했을 때 발생한 고민점에 대해서 공유하고자 합니다.