[API 명세서] 통합

회원

메서드	경로	설명
GET	/oauth2/authorization/google	계정 선택 (Google OAuth)
GET	/api/companies?name={name}	회사 이름 검색하기
GET	/api/companies?company-id={id}&name={name}	팀 검색
POST	/api/auth/sing-up	회원가입 (회원 정보 저장)
POST	/api/auth/sign-out	로그아웃
DELETE	/api/auth/account	회원 탈퇴

---

마이페이지

메서드	경로	설명
PUT	/api/me/meal/alone	혼밥 모드 ON/OFF
PUT	/api/me/meal/tags	알러지, 비선호 음식 수정

---

리뷰

메서드	경로	설명
POST	/api/teams/{teamId}/restaurants/{restaurantId}/reviews	리뷰 작성
GET	/api/teams/{teamId}/restaurants/{restaurantId}/reviews	리뷰 목록 조회
PUT	/api/teams/{teamId}/restaurants/{restaurantId}/reviews/{reviewId}	리뷰 수정
DELETE	/api/teams/{teamId}/restaurants/{restaurantId}/reviews/{reviewId}	리뷰 삭제

---

팀

메서드	경로	설명
POST	/api/teams	팀 생성
GET	/api/teams/{teamId}	팀 상세 조회
PUT	/api/teams/{teamId}	팀 정보 수정
DELETE	/api/teams/{teamId}	팀 삭제

---

팀 멤버십

메서드	경로	설명
POST	/api/teams/{teamId}/team-members	팀 가입 신청
POST	/api/teams/join?token=xxx	초대 링크 가입
DELETE	/api/teams/{teamId}/team-members/me	본인 팀 탈퇴
GET	/api/teams/{teamId}/team-members	팀 멤버 목록 조회
PATCH	/api/teams/{teamId}/team-members/{teamMemberId}/role	팀 멤버 역할 변경
DELETE	/api/teams/{teamId}/team-members/{teamMemberId}	팀 멤버 강퇴

---

초대 링크

메서드	경로	설명
POST	/api/teams/{teamId}/invitation	초대 링크 생성
GET	/api/teams/{teamId}/invitation	초대 링크 조회

---

식당

메서드	경로	설명
POST	/api/restaurants	식당 등록
GET	/api/restaurants	식당 검색 (내부 DB)
GET	/api/restaurants/kakao	식당 조회 (카카오 API)

---

팀 맛집

메서드	경로	설명
POST	/api/teams/{teamId}/restaurants	팀 맛집 등록
GET	/api/teams/{teamId}/restaurants	팀 맛집 목록 조회
GET	/api/teams/{teamId}/restaurants/{teamRestaurantId}	팀 맛집 상세 조회
PUT	/api/teams/{teamId}/restaurants/{teamRestaurantId}	팀 맛집 정보 수정
DELETE	/api/teams/{teamId}/restaurants/{teamRestaurantId}	팀 맛집 삭제

---

팀 멤버 검색/조회 기록

메서드	경로	설명
GET	/api/teams/{teamId}/team-members/me/search-history	내 검색 기록 조회
GET	/api/teams/{teamId}/team-members/me/view-history	내 조회 기록 조회

---

팟

메서드	경로	설명
POST	/api/teams/{teamId}/parties	팟 만들기
GET	/api/teams/{teamId}/parties	팟 목록 조회
GET	/api/teams/{teamId}/parties/{partyId}	팟 상세 조회
PUT	/api/teams/{teamId}/parties/{partyId}	팟 수정
DELETE	/api/teams/{teamId}/parties/{partyId}	팟 삭제

---

팟 참가

메서드	경로	설명
POST	/api/teams/{teamId}/parties/{partyId}/members	팟 참여하기
GET	/api/teams/{teamId}/parties/{partyId}/members	팟 참여자 조회

---

팟 투표

메서드	경로	설명
GET	/api/teams/{teamId}/parties/{partyId}/votes	투표 정보 조회
PUT	/api/teams/{teamId}/parties/{partyId}/votes/{voteId}	투표 정보 수정
POST	/api/teams/{teamId}/parties/{partyId}/votes/{voteId}/candidates	후보 식당 추가
DELETE	/api/teams/{teamId}/parties/{partyId}/votes/{voteId}/candidates/{candidateId}	후보 식당 삭제
POST	/api/teams/{teamId}/parties/{partyId}/votes/{voteId}/records	투표하기

---

팟 정산

메서드	경로	설명
POST	/api/teams/{teamId}/parties/{partyId}/settlements	정산 생성
POST	/api/teams/{teamId}/parties/{partyId}/settlements/{settlementId}/shares	정산 요청
PUT	/api/teams/{teamId}/parties/{partyId}/settlements/{settlementId}	정산 완료

---

소식

메서드	경로	설명
POST	/api/notices	소식 전송
GET	/api/notices	소식 전체 조회

---

이미지

메서드	경로	설명
GET	/api/images/uri	이미지 업로드용 URL 발급
DELETE	/api/images	이미지 삭제