추가 기능 - 승인제 참여 확장 명세 #24
claudia99503
started this conversation in
Ideas
Replies: 1 comment 2 replies
-
Beta Was this translation helpful? Give feedback.
2 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
-
V2 Group API – 승인제 참여 확장 명세
18. 모임 참여 신청 (승인제 전용)
POST /api/v2/groups/{groupId}/attendance/request
APPROVAL_REQUIRED 모임에 대해
참여를 “신청(PENDING)” 하는 API입니다.
FREE 모임에서는 사용할 수 없습니다.
📥 Request
POST /api/v2/groups/{groupId}/attendance/request
Headers
Path Variables
Body
{ "message": "저도 참여하고 싶습니다!" }참여 신청 정책
로그인 사용자만 가능
JWT 필수
승인제 모임에서만 가능
joinPolicy = APPROVAL_REQUIRED
FREE 모임 호출 시 오류
기존 멤버십 상태에 따른 처리
📤 Response (200 OK)
{ "status": 200, "success": true, "data": { "groupId": 10, "joinPolicy": "APPROVAL_REQUIRED", "myMembership": { "groupUserId": 55, "role": "MEMBER", "status": "PENDING" }, "serverTime": "2025-12-24T13:22:01.123456" } }오류 케이스
19. 참여 신청 취소 (PENDING 전용)
POST /api/v2/groups/{groupId}/attendance/request/cancel
승인 대기 중(PENDING)인 참여 신청을 취소하는 API입니다.
📥 Request
POST /api/v2/groups/{groupId}/attendance/request/cancel
Headers
Path Variables
Body 없음
참여 신청 취소 정책
로그인 사용자만 가능
대상 멤버십 상태 제한
📤 Response (200 OK)
{ "status": 200, "success": true, "data": { "groupId": 10, "canceled": true, "serverTime": "2025-12-24T13:25:11.789012" } }오류 케이스
20. 승인 대기자 목록 조회 (승인 페이지)
GET /api/v2/groups/{groupId}/attendance/pending
승인제 모임에 대해
현재 PENDING 상태인 신청자 목록을 조회하는 API입니다.
📥 Request
GET /api/v2/groups/{groupId}/attendance/pending
Headers
Path Variables
조회 정책
HOST만 조회 가능
승인제 모임에서만 가능
반환 대상
📤 Response (200 OK)
{ "status": 200, "success": true, "data": { "groupId": 10, "joinPolicy": "APPROVAL_REQUIRED", "pendingMembers": [ { "userId": 201, "groupUserId": 55, "nickName": "Applicant1", "profileImage": null, "profileMessage": "백엔드 개발자", "requestMessage": "참여하고 싶습니다!", "requestedAt": "2025-12-24T13:20:10.123456" } ], "serverTime": "2025-12-24T13:30:00.000000" } }오류 케이스
(중요) 승인제 모임 조회 API 적용 규칙
기존 V2 API에서
승인제 모임(APPROVAL_REQUIRED) + 사용자 멤버십 상태가 PENDING 인 경우
다음 UI 동작을 보장해야 합니다.
적용 대상 API
모임 목록 조회
GET /api/v2/groups내 모임 목록 조회
GET /api/v2/groups/me모임 상세 조회
GET /api/v2/groups/{groupId}공통 규칙
myMembership.status = PENDING인 경우PENDING 상태의 모임에 대해
Beta Was this translation helpful? Give feedback.
All reactions