Meeting

초대 코드로 모임 조회

초대 링크 진입 화면에서 사용할 모임 정보를 조회합니다.<br> 참여 가능 여부와 마감/정원 초과 안내 문구를 함께 반환합니다. 로그인한 사용자는 선택적으로 Authorization: Bearer {accessToken} 헤더를 보내면 이미 참여한 모임인지도 확인할 수 있습니다. 닉네임 온보딩 전 사용자도 조회할 수 있으며, 헤더 없이 호출하면 기존 공개 조회와 동일하게 동작합니다. 모임장 프로필 이미지는 아직 사용자 프로필 정책이 확정되지 않아 응답에 포함하지 않았고, 프로필 정책 확정 후 협의하여 확장할 예정입니다. 진행상황 확인 버튼은 추후 VIEW-01 모임 현황 API와 연결됩니다.

get/api/meetings/invitations/{inviteCode}

Request

Base URL: https://3-35-119-70.sslip.io
URL: https://3-35-119-70.sslip.io/api/meetings/invitations/{inviteCode}
Auth: none declared

Path parameters

inviteCodestring required

Response

초대 코드 모임 조회 성공

meetingIdinteger

서버에서 모임을 식별하는 ID

namestring

초대 링크 진입 화면에 표시할 모임 이름

descriptionstring nullable

초대 링크 진입 화면에 표시할 모임 설명. 입력하지 않은 경우 null입니다.

coverImageUrlstring nullable

이미 저장된 커버 이미지를 <img src>에 표시할 때 쓰는 상대 API 경로입니다. API 서버 주소를 앞에 붙여 사용하며, v 값은 캐시 갱신용이므로 변경하지 않습니다. 커버가 없으면 null입니다.

maxParticipantsinteger

최대 참여 인원. 방장을 포함합니다.

planningType'SCHEDULE_ONLY' | 'PLACE_ONLY' | 'SCHEDULE_AND_PLACE'

모임 생성 유형입니다.

<ul> <li>SCHEDULE_ONLY: 일정만 정하기</li> <li>PLACE_ONLY: 장소만 정하기</li> <li>SCHEDULE_AND_PLACE: 일정과 장소 모두 정하기</li> </ul>

status'PLANNING' | 'CONFIRMED'

모임의 최종 확정 상태입니다. PLANNING은 아직 최종 확정 전, CONFIRMED는 필요한 일정·장소 선택이 모두 확정된 상태입니다.

scheduleMode'VOTE' | 'NONE'

일정 설정 방식입니다.

<ul> <li>VOTE: 일정 조율</li> <li>NONE: 일정 없음</li> </ul> 현재 MVP 생성 API에서는 FIXED 직접 입력을 받지 않습니다.

scheduleInputType'DATE_ONLY' | 'DATE_AND_TIME' | 'NONE'

일정 참여 입력 유형입니다.

placeMode'RECOMMEND' | 'NONE'

장소 설정 방식입니다.

<ul> <li>RECOMMEND: 장소 추천/확정 플로우에서 장소를 정함</li> <li>NONE: 장소 없음</li> </ul> 현재 MVP 생성 API에서는 FIXED 직접 입력을 받지 않습니다.

placeRecommendationStrategy'MIDDLE_POINT' | 'RANDOM' nullable

생성 시 선택한 장소 추천 방식입니다. placeMode=RECOMMEND가 아니면 null입니다. 1차 MVP에서는 생성 후 변경하지 않으며, 생성 시점에는 추천 결과나 확정 장소를 만들지 않습니다.

<ul> <li>MIDDLE_POINT: 참여자 출발지를 기준으로 추후 중간지점 추천 진행</li> <li>RANDOM: 추후 랜덤 방식으로 장소 추천 진행</li> </ul>

deadlineAtstring date-time nullable

서버가 계산한 모임 참여/응답 마감 일시입니다. 마감 없는 모임에서는 null입니다.

participantCountinteger

현재 참여 인원. 방장을 포함합니다.

hostNicknamestring

방장으로 표시할 닉네임

Example response

{
  "meetingId": 1,
  "name": "주말 저녁 모임",
  "description": "오랜만에 같이 저녁 먹어요.",
  "coverImageUrl": "/api/meetings/invitations/ABCD234567/cover-image?v=15v9zq",
  "maxParticipants": 6,
  "planningType": "SCHEDULE_AND_PLACE",
  "status": "PLANNING",
  "scheduleMode": "VOTE",
  "scheduleInputType": "DATE_AND_TIME",
  "scheduleCandidateDates": [
    {
      "candidateDate": "2026-07-10",
      "availableTimeRanges": [
        {
          "startTime": "18:00",
          "endTime": "20:00"
        }
      ]
    }
  ],
  "placeMode": "RECOMMEND",
  "placeRecommendationStrategy": "MIDDLE_POINT",
  "deadlineAt": "2026-07-01T18:00:00",
  "participantCount": 1,
  "hostNickname": "moyeo1",
  "participationStatus": {
    "canJoin": true,
    "reason": "AVAILABLE",
    "message": "기한이 지난 모임이에요. 아쉽지만 현재는 더 이상 참여할 수 없어요."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.