본문으로 건너뛰기

Community & Notification API

커뮤니티 참가 및 알림 관련 엔드포인트입니다.

Community 엔드포인트 목록​

메서드경로설명인증
GET/api/community/interests관심사 선택지 조회필요
POST/api/community/join커뮤니티 참가 신청필요
—(관리자 엔드포인트)내부 관리용, 별도 문서 참조필요 (ADMIN)

GET /api/community/interests​

친구모임·소개팅 카테고리별 선택 가능한 관심사 옵션 목록을 반환합니다.

POST /api/community/join​

기수에 참가 신청합니다. 정원 초과 방지를 위해 DB 수준의 비관적 락이 적용됩니다. 정원이 차면 카카오 오픈채팅 링크가 알림톡으로 발송됩니다.

에러:

상황HTTP
이미 참가한 경우400
정원이 가득 찬 경우400
유효하지 않은 관심사400
커뮤니티 없음404

Notification 엔드포인트 목록​

메서드경로설명인증
GET/api/notifications내 알림 목록 조회 (최신순)필요
GET/api/notifications/unread-count미읽음 알림 개수 조회필요
POST/api/notifications/{id}/read알림 읽음 처리필요
—(관리자 엔드포인트)내부 관리용, 별도 문서 참조필요 (ADMIN)

GET /api/notifications​

가입 이후 등록된 알림 목록을 최신순으로 반환합니다. 각 항목에 읽음 여부(read)가 포함됩니다.

GET /api/notifications/unread-count​

앱 종 아이콘 뱃지 표시용 미읽음 알림 개수를 반환합니다.

POST /api/notifications/{id}/read​

특정 알림을 읽음 상태로 변경합니다. 이미 읽은 경우 무시됩니다.

Response: 204 No Content