웹페이지 전체 흐름 API 정리

1. 로그인

   • GET 유저 oAuth 인증(구글) → FE
     • POST /auth/google
   • 최초 로그인 여부 확인(자동 로그인에 필요)
     • GET /users/{userId}
   • 최초 로그인일 경우 POST 새 유저 등록
     • POST /users

2. 모임 추가(신규등록)

   • POST /clubs

3. 메인 페이지

   • 마감임박순 독서모임 조회 (_ 개만)

   → GET/

4. 보드 페이지

   • 전체 모임 리스트 조회 (페이지당 6개의 독서모임 조회) , 정렬은 최신순

   → GET/clubs/tags=&clubStatus=&page={page}

   • 태그, 모집중 여부 기준으로 필터링된 모임 조회

   → GET/clubs?tags={tags}&clubStatus={clubStatus}&page={page}

   • 모임에 좋아요 클릭

   → POST/likedClubs

   • 모임에 좋아요 취소

   → DELETE/likedClubs?clubId={clubId}&userId={userId}

5. 모임 상세조회

   • 모임 상세 정보 조회

   → GET/clubs/{clubId}

   • 참여 신청 버튼 클릭

   → POST/members

   • 참여 신청 취소

   → DELETE/members?userId={userId}&clubId={clubId}&delete={deleteStatus}

   • 댓글 조회

   → GET/comments/clubs/{clubs}

   • 댓글 등록

   → POST/comments

   • 댓글 수정

   → GET/comments/{commentId}

   • 댓글 삭제

   → DELETE/comments/{commentId}

6. 마이 페이지

   • 참여중인 모임 조회

   → GET/members/users/{userId}?page={page}

   • 좋아요한 모임 조회

   → GET/likedClubs/users/{userId}?page={page}

   • 내가 운영중인 모임 관리

     1. 운영중인 모임 조회 ( 운영 가능 모임 수 : 현재 최대 4개 )

     → GET/clubs/users/{userId}?page={page}

     b. 참여자 관리

     • 승인 대기자 리스트 조회

     → GET/members?userId={userId}&clubId={clubId}&approvalStatus=WAITING&page={page}

     • 승인 대기자 승인

     → PUT/members

     • 승인 대기자 거절

     → DELETE/members?userId={userId}&clubId={clubId}&delete={deleteStatus}

     • 참여자 목록 조회

     → GET/members?userId={userId}&clubId={clubId}&approvalStatus=CONFIRMED&page={page}

     c. 모임 정보 수정

     → PUT/clubs/users/{clubId}

     d. 모임 삭제

     → DELETE/clubs/users/{clubId}

   1. FE 필요에 의한 별도 API
   • 좋아요한 모임 아이디 조회

   → GET/likedClubs/ids?userId={userId}

   • 참여중인 모임 아이디 조회

   → GET/members/ids?userId={userId}