[Spring Boot / 백엔드] API 요청부터 응답까지 - 회원가입 흐름으로 보는 Controller, Service, Repository

백엔드 개발을 하다 보면 Controller, Service, Repository를 나누는 이유는 어느 정도 익숙해집니다. 그런데 막상 API 하나를 구현하고 나면 이런 생각이 들 때가 있습니다.“그래서 실제 요청이 들어오면, 이 계층들은 어떤 순서로 동작하는 걸까?” 저도 처음에는 Controller가 요청을 받고 Service가 로직을 처리하고 Repository가 저장한다는 정도로만 이해했습니다.하지만 회원가입 API처럼 요청값 검증도 들어가고, 여러 테이블 저장도 필요하고, 마지막에는 공통 응답 형식으로 감싸서 반환하는 흐름을 하나씩 따라가다 보니 각 계층이 왜 분리되어 있는지 훨씬 선명하게 보였습니다. 그래서 이번 글에서는 회원가입 API 하나를 기준으로, 클라이언트가 요청을 보낸 순간부터 DB..

• format_list_bulleted 백엔드
• · 2026. 4. 23.

[Spring Boot / 백엔드] API 설계하기 - API 명세서, RESTful API

백엔드 개발을 공부하다 보면 기능을 구현하는 것만큼이나 API를 어떻게 설계할지 고민하게 됩니다.처음에는 저도 API를 단순히 “프론트와 서버가 통신하기 위한 주소” 정도로만 생각했습니다.그런데 직접 기능을 만들다 보니, 같은 기능이어도어떤 URL로 설계할지,어떤 HTTP 메서드를 써야 할지,어떤 데이터를 어디에 담아 보내야 할지에 따라협업 난이도와 유지보수성이 꽤 달라진다는 걸 느꼈습니다. 그래서 이번 글에서는 워크북 내용을 바탕으로API 명세서가 무엇인지,RESTful API는 어떻게 설계하는지,그리고 실제로 어떤 기준으로 API를 나누고 문서화해야 하는지를 정리해보려고 합니다.이번 글에서 다룰 내용은 다음과 같습니다.API란 무엇인가REST API와 RESTful한 설계HTTP 메서드와 멱등성API..

• format_list_bulleted 백엔드
• · 2026. 4. 3.