음악 캘린더 API Documentation

음악 캘린더 서비스의 API 문서를 담고 있습니다.

---

Overview

• Title: 음악 캘린더 API
• Description: 음악 캘린더 서비스에 관한 API 문서화
• Version: 1.0.0
• Base URL: http://localhost:8080/api/v1
• Security: JWT (Bearer 토큰 사용)

---

Endpoints

Users API

Method	URL	Summary
POST	/user/signup	회원가입
POST	/user/login	로그인
POST	/user/refresh	JWT 재발급
POST	/user/image	이미지 변경
PUT	/user/userIntro	자기소개 변경
PUT	/user/profileName	이름 변경
PATCH	/user/calendar-visibility	캘린더 공개 여부 수정
GET	/user/search	유저 검색
GET	/user/getUsers	내 유저 정보 조회
GET	/user/{user-id}	유저 ID로 조회
GET	/user/byToken	토큰으로 유저 조회
GET	/user/byCookie	쿠키로 유저 조회
GET	/user/spotify-token	Spotify 토큰 조회
GET	/user/logout	로그아웃
GET	/user/testApi	테스트 API
GET	/user/check-duplicate	아이디 중복 확인

---

Calendar API

Method	URL	Summary
GET	/calendar	먼슬리 캘린더 조회
POST	/calendar	캘린더 생성
GET	/calendar/{calendar-date-id}	특정 날짜 캘린더 조회
PATCH	/calendar/{calendar-date-id}/memo	메모 수정
PUT	/calendar/{calendar-date-id}/music	음악 기록 수정
GET	/calendar/today	오늘 날짜 캘린더 조회

---

Music API

Method	URL	Summary
GET	/music	전체 음악 목록 조회
GET	/music/{id}	ID로 음악 조회
DELETE	/music/{id}	ID로 음악 삭제
POST	/music/save-all	음악 리스트 저장
GET	/music/spotify/{id}	Spotify ID로 검색
POST	/music/spotify/{id}	Spotify ID로 저장
GET	/music/spotify/search	키워드로 Spotify 검색
GET	/music/spotify/playlist	사용자 Spotify Playlist 조회
GET	/music/spotify/playlist/{playlistId}	Playlist 트랙 조회
GET	/music/spotify/artist/{artistId}/top-tracks	아티스트 인기곡 조회
GET	/music/recent/random/{userId}	랜덤 최근 음악 조회

---

Notification API

Method	URL	Summary
GET	/notifications	전체 알림 조회
GET	/notifications/{notification-id}	알림 단건 조회
GET	/notifications/modify	변경 가능 알림 목록 조회
GET	/notifications/lists	사용자 알림 조회
PUT	/notifications/{notification-id}/modify	알림 시간 변경
PATCH	/notifications/update	알림 설정 업데이트

---

Notification List API

Method	URL	Summary
GET	/notification-lists	내 알림리스트 조회
PATCH	/notification-lists/{notificationList-id}	알림 읽음 처리 단건
DELETE	/notification-lists/{notificationList-id}	알림 삭제
PATCH	/notification-lists/mark-all-read	전체 읽음 처리

---

Subscription (푸시 구독)

Method	URL	Summary
POST	/push/subscribe	푸시 구독 정보 저장

---

Follows API

Method	URL	Summary
POST	/follows/{user-id}	팔로우 요청
DELETE	/follows/delete/{user-id}	팔로우 삭제
DELETE	/follows/reject/{user-id}	팔로우 거절
PUT	/follows/accept/{user-id}	팔로우 수락
GET	/follows/my	내 팔로잉 목록 조회
GET	/follows/my/pending	팔로워 요청 목록 조회
GET	/follows/following/{user-id}	유저의 팔로잉 목록 조회
GET	/follows/follower/{user-id}	유저의 팔로워 목록 조회
GET	/follows/count/{user-id}	팔로우 수 조회

---

Membership API

Method	URL	Summary
POST	/membership/init	기본 멤버십 생성
POST	/membership/cancel	멤버십 해지
GET	/membership/my	내 멤버십 조회
GET	/membership/admin	전체 멤버십 목록 (관리자 전용)
PATCH	/membership/admin/{id}	멤버십 수정 (관리자 전용)

---

Payment API

Method	URL	Summary
POST	/payment/subscribe	정기 결제 구독 요청 (토스)
POST	/payment/confirm	결제 확인 요청

---

Recap API

Method	URL	Summary
GET	/recap?startDate=&endDate=	전체 음악 기록 조회

---

Email API

Method	URL	Summary
GET	/userEmail/emailAuth?email=	이메일 인증코드 발송

---

Spotify Connect API

Method	URL	Summary
GET	/spotify/callback	Spotify 계정 연동 콜백
GET	/spotify/logout	Spotify 로그아웃