엔드포인트 설계(프론트, 백 HTTP통신시 중요)

 

1. 리소스 중심 (RESTful): URL은 '무엇'을 다루는지에 집중 (/posts, /users, /places)
2. 행동은 HTTP Method로 표현: GET, POST, PUT, DELETE, PATCH
3. 명확하고 일관된 구조: /api/{리소스}/{id}, 서브리소스는 /api/{리소스}/{id}/{하위리소스}
4. 접두어 통일: /api 고정, 관리자는 /api/admin 따로
5. 간결하면서 직관적: 의미 있는 단어만 사용하고, 복잡한 쿼리는 파라미터로

 

리소스 메서드 엔드포인트 예시 설명

게시글 조회	GET	/api/posts	전체 게시글 조회
게시글 작성	POST	/api/posts	게시글 생성
게시글 상세	GET	/api/posts/{postId}	특정 게시글 조회
게시글 수정	PUT	/api/posts/{postId}	게시글 전체 수정
게시글 삭제	DELETE	/api/posts/{postId}	게시글 삭제
장소 검색	GET	/api/places/search?keyword=서울	키워드로 장소 검색
장소 목록	GET	/api/places	전체 장소 조회
내 글 조회	GET	/api/users/{userId}/posts	특정 유저의 게시글 목록
댓글 작성	POST	/api/posts/{postId}/comments	특정 게시글에 댓글 작성
퀴즈 목록 조회	GET	/api/quizzes	퀴즈 리스트
퀴즈 관리(관리자)	POST/PUT/DELETE	/api/admin/quizzes	관리자 전용 퀴즈 관리