Service Docs 0.170.0 버전

Change log — 0.170.0

직전 release 0.169.00.170.0 의 API 차이.

✨ 새 method (107)

  • addPostBookmarkPOST /spaces/{spaceId}/community/{postId}/bookmark — 게시글 북마크 추가 (멱등)
  • attachLivePUT /tenants/me/contents/{id}/live — 라이브(외부 회의 링크 + 시작·종료 시각) 연결
  • bulkCancelInvitationsPOST /tenants/me/invitations/cancel — 초대 일괄 취소 — 건별 결과
  • bulkCreateJobsPOST /tenants/me/jobs/bulk — 직무 일괄 생성 — 중복은 건너뛰고 리포트
  • bulkResendInvitationsPOST /tenants/me/invitations/resend — 초대 일괄 재발송 — 건별 결과
  • bulkResetMemberPasswordPOST /tenants/me/members/bulk-reset-password — 멤버 비밀번호 일괄 재설정 — 건별 처리 후 실패 리포트(전체 롤백 아님). 응답에 비밀번호 없음
  • changeSessionTypePOST /auth/session-type — 세션 유형 변경 — family 유지 rotate + 절대 만료 재계산 (Set-Cookie 재발급)
  • checkInvitationsPOST /tenants/me/invitations/check — 초대 사전 검사 — 이메일별 초대 가능 여부
  • checkLoginMethodsPOST /tenants/{tenantKey}/login-config/check — 로그인 전 계정 존재·로그인 수단 조회 (비인증). 429 면 클라는 그냥 다음 단계로 진행
  • checkUserGroupMembersPOST /tenants/me/user-groups/{id}/members/check — 그룹 멤버 추가 사전 검증(이메일·고유번호)
  • clientGetAssignmentGET /spaces/{spaceId}/content/contents/{id}/assignment — 과제 정보 + 내 제출(클라)
  • clientGetAssignmentSimilarityGET /spaces/{spaceId}/content/contents/{id}/assignment/similarity — 내 제출물 표절 검사 결과(클라)
  • clientGetAssignmentSimilarityViewGET /spaces/{spaceId}/content/contents/{id}/assignment/similarity/view — 내 표절 검사 상세 뷰 URL(클라)
  • clientGetGroupAssignmentGET /spaces/{spaceId}/content/contents/{id}/group-assignment — 그룹과제 정보 + 우리 팀 제출(클라)
  • clientGetLiveGET /spaces/{spaceId}/content/contents/{id}/live — 라이브 정보(클라, 진행 상태 포함)
  • clientGetPeerAssessmentGET /spaces/{spaceId}/content/contents/{id}/peer-assessment — 상호평가 문항·대상·내 제출(클라)
  • confirmOtpSignInPOST /auth/otp/sign-in/confirm — 코드 로그인 — 확정 (비인증). 응답은 /auth/sign-in 과 동형(access + Set-Cookie)
  • createEntryCodePOST /tenants/me/entry-codes — 기관 입장 코드 발급
  • createSpaceGroupPOST /tenants/me/spaces/{spaceId}/group-sets/{setId}/groups — 팀 생성
  • createSpaceGroupSetPOST /tenants/me/spaces/{spaceId}/group-sets — 팀활동 생성
  • deleteEntryCodeDELETE /tenants/me/entry-codes/{id} — 기관 입장 코드 삭제
  • deleteSpaceGroupDELETE /tenants/me/spaces/{spaceId}/group-sets/{setId}/groups/{groupId} — 팀 삭제
  • deleteSpaceGroupSetDELETE /tenants/me/spaces/{spaceId}/group-sets/{setId} — 팀활동 삭제
  • getAssignmentGET /tenants/me/contents/{id}/assignment — 과제 설정(매니저)
  • getAssignmentRubricGET /tenants/me/contents/{id}/assignment/rubric — 과제 루브릭(매니저 — 공개 범위 무관)
  • getAssignmentSimilarityGET /tenants/me/contents/{id}/assignment/similarity/{profileId} — 제출물 표절 검사 결과(관리자)
  • getAssignmentSimilarityViewGET /tenants/me/contents/{id}/assignment/similarity/{profileId}/view — 표절 검사 상세 뷰 URL(관리자)
  • getAssignmentSubmissionGET /tenants/me/contents/{id}/assignment/submissions/{submissionId} — 과제 제출물 상세(최신 + 이력)
  • getGroupAssignmentGET /tenants/me/contents/{id}/group-assignment — 그룹과제 설정 + 팀활동 연결 유효성
  • getGroupAssignmentSubmissionGET /tenants/me/contents/{id}/group-assignment/submissions/{submissionId} — 그룹과제 제출물 상세(최신 + 이력)
  • getGroupGradeConfigGET /tenants/me/spaces/{spaceId}/group-sets/{setId}/grade — 팀 성적 설정(평가 항목·비중)
  • getLiveGET /tenants/me/contents/{id}/live — 라이브 정보(매니저)
  • getLoginConfigDraftGET /tenants/me/login-config/draft — 기관 로그인 설정 임시 저장본 조회
  • getMemberEnrollmentGET /tenants/me/members/{userPkId}/enrollments/{profileId}/{spaceId} — 구성원의 프로필·공간별 수강 이력 상세
  • getPeerAssessmentGET /tenants/me/contents/{id}/peer-assessment — 상호평가 설정·문항 + 연결 유효성
  • getPeerAssessmentDraftGET /spaces/{spaceId}/content/contents/{id}/peer-assessment/draft — 상호평가 임시저장 불러오기
  • getPeerAssessmentResultGET /tenants/me/contents/{id}/peer-assessment/result — 상호평가 결과(대상별 문항 평균)
  • getPositionGET /tenants/me/positions/{id} — 직위 상세
  • getPremiumCodeGET /tenants/me/premium-code — 기관 프리미엄 코드 조회(없으면 발급)
  • getPublicExternalFeedGET /tenants/{tenantKey}/login-config/external-feed — 기관 대문 외부 공지 피드 (비인증, 실패도 200)
  • getSessionTypeGET /auth/session-type — 현재 세션 유형 — confirmed=false 면 프론트가 유형을 묻는다
  • getSimilarityCheckConfigGET /tenants/me/similarity-check — 표절 검사(CopyKiller) 연동 설정 조회
  • getUnassignedOrgMembersGET /tenants/me/orgs/unassigned — 조직 미배정 구성원 목록
  • gradeAssignmentSubmissionPOST /tenants/me/contents/{id}/assignment/submissions/{submissionId}/grade — 과제 채점(점수 + 피드백)
  • gradeGroupAssignmentSubmissionPOST /tenants/me/contents/{id}/group-assignment/submissions/{submissionId}/grade — 그룹과제 채점(팀 단위)
  • grantPermissionBulkPOST /tenants/me/permissions/{code}/grants/bulk — 그룹/멤버에 권한 일괄 부여
  • inviteUserGroupToSpacesPOST /tenants/me/user-groups/{id}/space-invitations — 그룹 단위 공간 초대(공간 다중) — 스냅샷, 공간별 결과 리포트
  • joinLivePOST /spaces/{spaceId}/content/contents/{id}/live/join — 라이브 입장(진행 중이면 진도 완료)
  • listAssignmentSubmissionsGET /tenants/me/contents/{id}/assignment/submissions — 과제 제출물 목록(사용자별 최신)
  • listEntryCodesGET /tenants/me/entry-codes — 기관 입장 코드 목록
  • listGroupAssignmentMemberScoresGET /tenants/me/contents/{id}/group-assignment/submissions/{submissionId}/member-scores — 팀 제출물 구성원 개별 점수
  • listGroupAssignmentSubmissionsGET /tenants/me/contents/{id}/group-assignment/submissions — 그룹과제 제출물 목록(팀별 최신)
  • listGroupGradeMembersGET /tenants/me/spaces/{spaceId}/group-sets/{setId}/grade/members — 팀 성적 구성원별 결과
  • listMemberEnrollmentsGET /tenants/me/members/{userPkId}/enrollments — 구성원의 수강 이력(공간별 진도 요약)
  • listMemberOrgsGET /tenants/me/members/{userPkId}/orgs — 구성원의 소속 조직 + 직위
  • listMemberSpacesGET /tenants/me/members/{userPkId}/spaces — 구성원의 참여 공간 목록
  • listMyProfilesGET /me/profiles — 내 프로필 목록(선택 화면) — 고유번호 오름차순
  • listMySpaceGroupsGET /spaces/{spaceId}/my-groups — 내 팀 목록(공개된 팀활동만)
  • listPermissionCandidatesGET /tenants/me/permissions/{code}/candidates — 부여 대상 후보(아직 권한이 없는 구성원)
  • listPositionMembersGET /tenants/me/positions/{id}/members — 직위 소속 구성원
  • listSpaceGroupsGET /tenants/me/spaces/{spaceId}/group-sets/{setId}/groups — 팀 목록(+멤버)
  • listSpaceGroupSetsGET /tenants/me/spaces/{spaceId}/group-sets — 팀활동 목록
  • listTenantsByEmailPOST /auth/tenants/by-email — 소속 기관 전체 조회 (비인증) — 코드 검증, 비밀번호 무관. 코드는 소비하지 않는다
  • listUnassignedPositionMembersGET /tenants/me/positions/unassigned — 직위 미설정 구성원 목록
  • listUnassignedSpaceMembersGET /tenants/me/spaces/{spaceId}/group-sets/{setId}/unassigned — 팀 미배정 참여자 목록
  • listUserGroupMembersGET /tenants/me/user-groups/{id}/members — 그룹 멤버 목록 — 검색·페이지네이션
  • markProfileVisitedPOST /me/profiles/{profileId}/visited — 프로필 방문 기록(isNew 해제)
  • moveOrgMembersPOST /tenants/me/orgs/{id}/members/move — 조직 간 구성원 이동
  • myNotificationSettingsGET /me/notification-settings — 개인 알림 설정 조회 — 모든 타입×플랫폼(미설정은 on)
  • myPushTokensGET /me/push-tokens — 내 푸시 토큰 목록(기기 확인용)
  • publishLoginConfigDraftPOST /tenants/me/login-config/draft/publish — 임시 저장본을 실제 설정으로 적용
  • redeemPremiumCodePOST /tenants/me/premium-code/redeem — 프리미엄 코드 입력 — 본인에게 권한 부여
  • registerPushTokenPOST /me/push-tokens — 푸시 토큰 등록 (멱등, 소유자 이전)
  • reissuePremiumCodePOST /tenants/me/premium-code/reissue — 프리미엄 코드 재발급(옛 코드는 즉시 무효)
  • removeOrgMembersPOST /tenants/me/orgs/{id}/members/remove — 조직 구성원 일괄 제거
  • removePostBookmarkDELETE /spaces/{spaceId}/community/{postId}/bookmark — 게시글 북마크 해제 (멱등)
  • reorderPositionsPOST /tenants/me/positions/reorder — 직위 순서 일괄 변경
  • requestOtpSignInPOST /auth/otp/sign-in/request — 코드 로그인 — 코드 요청 (비인증). 가입 여부를 응답으로 알려주지 않는다
  • requestTenantSignUpPOST /tenants/{tenantKey}/sign-up/request — 기관 대문 가입 — 인증 코드 발송 (비인증). 가입을 받지 않는 기관은 403
  • resolveEntryCodePOST /entry-codes/resolve — 코드/링크로 기관·공간 해석 (비인증). 만료·비활성·없음 모두 404
  • returnAssignmentSubmissionPOST /tenants/me/contents/{id}/assignment/submissions/{submissionId}/return — 과제 반려(재제출 요구)
  • returnGroupAssignmentSubmissionPOST /tenants/me/contents/{id}/group-assignment/submissions/{submissionId}/return — 그룹과제 반려(팀 단위)
  • revokePermissionBulkPOST /tenants/me/permissions/{code}/revoke/bulk — 그룹/멤버 권한 일괄 해제
  • runGroupGradeScoringPOST /tenants/me/spaces/{spaceId}/group-sets/{setId}/grade/scoring — 팀 성적 계산(구성원 환산 총점 저장)
  • saveLoginConfigDraftPATCH /tenants/me/login-config/draft — 기관 로그인 설정 임시 저장(부분 허용)
  • savePeerAssessmentDraftPOST /spaces/{spaceId}/content/contents/{id}/peer-assessment/draft — 상호평가 자동 임시저장(부분 저장)
  • setAssignmentSimilarityPOST /tenants/me/contents/{id}/assignment/similarity — 과제 표절 검사 사용 설정
  • setGroupAssignmentMemberScoresPOST /tenants/me/contents/{id}/group-assignment/submissions/{submissionId}/member-scores — 팀 제출물 구성원 개별 점수 저장
  • setMainProfilePATCH /me/profiles/main — 대표 프로필 변경
  • setPremiumCodeEnabledPATCH /tenants/me/premium-code — 프리미엄 코드 활성/비활성
  • setSpaceGroupMembersPOST /tenants/me/spaces/{spaceId}/group-sets/{setId}/groups/{groupId}/members — 팀원 배정(전체 교체, 리더 지정 포함)
  • submitAssignmentPOST /spaces/{spaceId}/content/contents/{id}/assignment/submit — 과제 제출(본문 + 첨부)
  • submitGroupAssignmentPOST /spaces/{spaceId}/content/contents/{id}/group-assignment/submit — 그룹과제 제출(팀 단위)
  • submitPeerAssessmentPOST /spaces/{spaceId}/content/contents/{id}/peer-assessment/submit — 상호평가 제출(대상 전체, 재제출은 갱신)
  • tenantSignUpPOST /tenants/{tenantKey}/sign-up — 기관 대문 가입 확정 — 코드 검증 후 계정 생성 + 로그인(access + Set-Cookie)
  • unregisterPushTokenDELETE /me/push-tokens/{token} — 푸시 토큰 해지 (멱등)
  • updateEntryCodePATCH /tenants/me/entry-codes/{id} — 기관 입장 코드 활성/비활성
  • updateGroupGradeConfigPATCH /tenants/me/spaces/{spaceId}/group-sets/{setId}/grade — 팀 성적 설정 저장(환산 방식·비중)
  • updateMyNotificationSettingsPATCH /me/notification-settings — 개인 알림 설정 저장 — 보낸 항목만 갱신(전체 교체 아님)
  • updatePostSchedulePATCH /spaces/{spaceId}/community/{postId}/schedule — 예약 발행 시각 변경(작성자, 발행 전만)
  • updateSimilarityCheckConfigPATCH /tenants/me/similarity-check — 표절 검사(CopyKiller) 연동 설정 수정
  • updateSpaceGroupPATCH /tenants/me/spaces/{spaceId}/group-sets/{setId}/groups/{groupId} — 팀 수정(이름·대표 이미지)
  • updateSpaceGroupSetPATCH /tenants/me/spaces/{spaceId}/group-sets/{setId} — 팀활동 수정(이름·공개 여부)
  • upsertAssignmentPUT /tenants/me/contents/{id}/assignment — 과제 설정 저장(만점·지각·재제출·필수 여부)
  • upsertAssignmentRubricPUT /tenants/me/contents/{id}/assignment/rubric — 과제 루브릭 저장(기준·레벨·공개 범위)
  • upsertGroupAssignmentPUT /tenants/me/contents/{id}/group-assignment — 그룹과제 설정(팀활동 연결·점수·제출 규칙)
  • upsertPeerAssessmentPUT /tenants/me/contents/{id}/peer-assessment — 상호평가 설정·문항 저장

⚠️ 시그니처 변경 (21)

  • addSpaceMembersPOST /tenants/me/spaces/{id}/members — 공간 멤버 추가(role 지정) — 차단·기존 멤버는 건별 리포트로 돌려준다
    • response schema 변경
  • communityFeedGET /spaces/{spaceId}/community — 커뮤니티 피드(필터/태그/검색)
    • query parameter filter schema 변경
  • deleteOrgDELETE /tenants/me/orgs/{id} — 조직 삭제 — 하위 조직까지 함께 삭제(레거시 파리티)
    • query parameter treeUpdatedAt 추가
  • ensureFeedbackRoomPOST /spaces/{spaceId}/community/{postId}/feedback/rooms — 피드백 대화방 확보(없으면 생성)
    • request body 추가
  • exportMembersGET /tenants/me/members/export — 멤버 CSV 내보내기 (현재 필터·정렬 반영)
    • query parameter fieldFilters schema 변경
    • query parameter userGroupId 추가
    • query parameter excludeUserGroupId 추가
  • getChallengeMemberDoneGET /tenants/me/spaces/{spaceId}/challenges/{id}/tasks/{taskId}/members/{profileId}/done — 참가자 완료 상세
    • path parameter profileId 추가 (required)
    • path parameter userId 제거
  • getChallengeMemberProgressGET /tenants/me/spaces/{spaceId}/challenges/{id}/members/{profileId}/progress — 참가자 진행 상세
    • path parameter profileId 추가 (required)
    • path parameter userId 제거
  • getMemberFieldValuesGET /tenants/me/members/{profileId}/field-values — 멤버 커스텀 필드 값 조회
    • path parameter profileId 추가 (required)
    • path parameter userId 제거
  • getOrgMembersGET /tenants/me/orgs/{id}/members — 조직 소속 구성원
    • query parameter search 추가
  • getPermissionDetailGET /tenants/me/permissions/{code} — 권한 상세(부여된 그룹/멤버)
    • query parameter page 추가
    • query parameter pageSize 추가
    • query parameter search 추가
  • listContentsGET /tenants/me/contents — 콘텐츠 목록(매니저/CMS)
    • query parameter type schema 변경
  • listInvitationsGET /tenants/me/invitations — 초대 목록 — 기본은 대기 중("초대 대기" 탭)
    • query parameter search 추가
    • query parameter sortBy 추가
    • query parameter sortDir 추가
  • listJobsGET /tenants/me/jobs — 직무 목록 — 검색·정렬·페이지네이션
    • query parameter page 추가
    • query parameter pageSize 추가
    • query parameter search 추가
    • query parameter sort 추가
    • query parameter order 추가
  • listMembersGET /tenants/me/members — 테넌트 멤버 목록 (검색·역할·상태·커스텀 필터 + 정렬 + 커스텀 필드 값)
    • query parameter fieldFilters schema 변경
    • query parameter userGroupId 추가
    • query parameter excludeUserGroupId 추가
  • listUserGroupsGET /tenants/me/user-groups — 유저 그룹 목록 — 검색·페이지네이션 + 멤버 아바타 + 적용 권한 수
    • query parameter page 추가
    • query parameter pageSize 추가
    • query parameter search 추가
  • removeChallengeMemberDELETE /tenants/me/spaces/{spaceId}/challenges/{id}/members/{profileId} — 챌린지 참가자 제외
    • path parameter profileId 추가 (required)
    • path parameter userId 제거
  • removeJobMemberDELETE /tenants/me/jobs/{id}/members/{profileId} — 직무에서 구성원 제거
    • path parameter profileId 추가 (required)
    • path parameter userId 제거
  • removeOrgMemberDELETE /tenants/me/orgs/{id}/members/{profileId} — 조직에서 구성원 제거
    • path parameter profileId 추가 (required)
    • path parameter userId 제거
  • removeSpaceMemberDELETE /tenants/me/spaces/{id}/members/{profileId} — 공간 멤버 제거(프로필 단위)
    • path parameter profileId 추가 (required)
    • path parameter userId 제거
  • removeUserGroupMemberDELETE /tenants/me/user-groups/{id}/members/{profileId} — 그룹 멤버 제거
    • path parameter profileId 추가 (required)
    • path parameter userId 제거
  • upsertMemberFieldValuesPUT /tenants/me/members/{profileId}/field-values — 멤버 커스텀 필드 값 저장(upsert)
    • path parameter profileId 추가 (required)
    • path parameter userId 제거

자동 생성: learning-server/openapi.json 의 OpenAPI 스펙 비교. JSDoc / 의미적 변경 (예: 응답 필드 의미 변경) 은 추적 안 됩니다 — commit 메시지 / GitHub Release 참고.