Time Machine(미리 보기)

Time Machine은 AI 기반 회사 학습 플랫폼입니다. 회사 문서, 비디오 및 전문가 지식을 모듈, 토픽, 퀴즈 및 롤플레이 연습을 통해 구조화된 과정으로 전환하고 학습자 진행 상황을 추적합니다. 직원을 대규모로 온보딩, 학습 및 인증하는 HR 및 L&D 팀을 위해 빌드되었습니다. 커넥터는 과정, 사용자, 부서 및 역할 관리와 같은 전체 학습 수명 주기를 자동화합니다. 문서에서 퀴즈 생성; 및 읽기 완료 분석

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역:
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 표준 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역:
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
파워 오토메이트 Premium 다음을 제외한 모든 Power Automate 지역:
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Contact
Name Time Machine 지원
URL https://timeml.ai
커넥터 메타데이터
Publisher Time Machine AI
웹 사이트 https://timeml.ai
개인 정보 보호 정책 https://timeml.ai/privacy-policy
카테고리 생산성; AI

Time Machine — Power Automate 커넥터

Time Machine이란?

Time Machine은 기업이 최신 팀을 위한 적응형 학습 시스템을 빌드, 운영 및 지속적으로 개선하는 데 도움이 되는 AI 기반 조직 학습 플랫폼입니다. 조직은 Time Machine을 사용하여 기존 지식, 문서, 기록 및 워크플로를 온보딩을 가속화하고, 인력 준비 상태를 개선하고, 조직 전체에서 최고의 성과를 내는 전문 지식을 복제하는 확장 가능한 교육 환경으로 변환합니다.

테넌트 관리자는 Time Machine REST API를 통해 사용자, 학습 콘텐츠, 조직 리소스 및 플랫폼 구성을 관리합니다. 이 커넥터는 공용 REST API를 Power Automate 작업으로 노출하므로 코드를 작성하지 않고도 사용자 프로비저닝, 콘텐츠 수집, 지식 동기화 및 수명 주기 관리를 자동화할 수 있습니다.

사전 요구 사항

  • 관리자 액세스 권한이 있는 활성 Time Machine 테넌트
  • 관리 패널(https://web.timeml.ai)의 설정 → API 키에서 발급된 Time Machine API 키입니다. 키는 .로 시작하는 값입니다 tm_live_.

Authentication

모든 작업은 헤더에서 API 키 Authorization 로 인증됩니다. Power Automate 연결을 만드는 경우:

  • 필드: API key
  • : 붙여넣기 Bearer tm_live_<your-token> (접두사 및 토큰 앞에 공백 포함 Bearer )

사용 가능한 작업

커넥터는 Time Machine 공용 REST API(116개 엔드포인트)를 미러링합니다. 작업은 리소스별로 그룹화됩니다.

  • 과정 - 강 좌 나열/만들기/업데이트/삭제/게시, 역할 할당, AI 제작 콘텐츠 생성
  • 사용자 - 사용자 나열/만들기/업데이트/비활성화/다시 활성화
  • 문서 - 문서 나열/업로드/업데이트/삭제
  • 미디어 - 미디어 항목 나열/업로드/업데이트/삭제
  • 부서 - 부서 나열/만들기/업데이트/삭제, 역할 관리, 역할에 사용자 할당
  • 전문가 - 전문가 프로필 나열/만들기, 전문가 질문, 문서 및 역할 할당
  • 데모 교육 - 데모 학습 나열/만들기/업데이트/삭제
  • 과정 콘텐츠 - 모듈, 토픽, 수업, 연습, 퀴즈 질문
  • 인사이트 - 학생별, 과정별 및 회사 수준 분석
  • 인증서 - 학생 인증서 나열, 인증서 PDF 다운로드

전체 엔드포인트 참조는 .에서 https://api.timeml.ai/api/v1/docs사용할 수 있습니다.

예제 워크플로

  • Confluence 릴리스 → Time Machine: 릴리스 페이지가 Confluence에 게시되면 학습 바이트 라이브러리로 전달되도록 Time Machine의 문서로 업로드합니다.
  • HR 온보딩: HRIS에 새 직원 행이 표시되면 부서 및 역할 할당을 사용하여 Time Machine 사용자를 만들어 매직 링크 초대를 트리거합니다.
  • 과정 완료 알림: 학생이 과정을 완료하면 인증서 PDF를 Slack에 보내고 완료를 Google Sheet에 기록합니다.

알려진 제한 사항

  • API 키 회전: API 키를 회전할 때 연결을 수동으로 업데이트해야 합니다. 자동 새로 고침 메커니즘은 없습니다.
  • 다중 파트 업로드: 파일 업로드 작업(문서 업로드, 미디어 업로드)은 최대 50MB의 파일을 허용합니다. 더 큰 미디어의 경우 여러 업로드로 분할하거나 Time Machine 지원에 문의하세요.
  • 일괄 처리 작업: API는 한 번에 하나의 레코드에서 작동합니다. 대량 작업의 경우 Power Automate 기본 제공 적용-각 컨트롤을 사용합니다.

Support

커넥터에 대한 질문이나 문제는 Time Machine 계정 팀 또는 전자 메일 지원팀에 support@timeml.ai문의하세요.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

Name Type Description Required
Time Machine API 키(형식: 전달자 tm_live_...) 시큐어스트링 (보안 문자열) 이 API에 대한 Time Machine API 키(형식: 전달자 tm_live_...) True

actions

AI 콘텐츠를 사용하여 전체 과정 생성

과정 셸, 모든 모듈, 모든 토픽을 만들고 모든 토픽에 대한 AI 콘텐츠 생성을 큐에 넣기

AI를 통해 특정 항목 다시 생성

단원, 단원 질문, 퀴즈, 소개 또는 연습을 다시 생성합니다.

과정 가져오기

모듈 요약 및 할당된 역할/부서를 사용하여 과정 메타데이터를 반환합니다.

과정 게시

과정을 게시합니다. 게시할 수 있는 콘텐츠가 없으면 400으로 실패합니다.

과정 나열

호출자 회사의 페이지를 매긴 과정 목록

과정 메타데이터 업데이트

과정 이름 업데이트

과정 버전 나열

버전 번호에 따라 정렬된 게시된 버전 메타데이터(개수 + 게시 정보)를 반환합니다.

과정 버전 스냅샷 가져오기

지정된 버전에 대한 전체 콘텐츠 트리(모듈, 토픽, 단원, 연습, 질문)를 반환합니다.

과정 삭제(소프트)

멱등원 — 과정이 이미 제거된 경우에도 204를 반환합니다.

과정에 대한 AI 생성 상태 가져오기

진행률 및 대상 정보가 포함된 과정에 대한 활성 AI 생성 요청 목록을 반환합니다.

과정에 모듈 추가

지정된 과정 내에 새 모듈을 만듭니다.

과정에 역할 할당

가산성 - 이미 할당된 역할은 건너뜁니다. 업데이트된 과정 세부 정보를 반환합니다.

과정의 모듈 나열

ordinalNumber로 정렬된 활성 모듈을 반환합니다.

단원 가져오기

단원 콘텐츠, 미디어 및 수업 내 질문을 반환합니다.

단원 내 질문 나열

지정된 단원에 첨부된 지식 점검 질문을 반환합니다.

단원 내 질문 삭제

Idempotent — 이미 제거된 경우에도 204

단원 내 질문 순서 다시 지정

questionIds는 수업에 대한 모든 활성 질문을 새 순서로 포함해야 합니다.

단원 내 질문 업데이트

저장된 형식과 일치하는 필드를 제공합니다. 관련 없는 필드는 무시됩니다.

단원 내 질문 추가

형식은 MULTIPLE_CHOICE(옵션 필요) 또는 OPEN_ENDED

단원 삭제(소프트)

Idempotent — 이미 제거된 경우에도 204

단원 콘텐츠 업데이트

생략된 콘텐츠는 현재 값을 유지합니다.

단원에서 질문 하나 받기

해당 ID로 단원 내 단일 질문을 반환합니다.

데모 교육 만들기

이전에 업로드한 비디오 파일에서 데모 학습을 만들고 처리를 시작합니다.

데모 교육 받기

세그먼트를 사용하여 전체 데모 학습을 반환합니다.

데모 교육 업데이트

부분 업데이트입니다. 변경하려는 필드만 전달합니다. assignedRoleIds는 현재 집합을 대체합니다.

데모 학습 나열

호출자의 회사로 범위가 지정된 페이지를 매긴 목록

데모 학습 삭제

Idempotent - 데모 학습이 없거나 이미 사라진 경우에도 204를 반환합니다.

모듈 가져오기

지정된 ID에 대한 모듈 세부 정보를 반환합니다.

모듈 내에서 항목 순서 다시 지정

topicIds는 모든 활성 토픽을 새 순서로 정확히 한 번 포함해야 합니다.

모듈 메타데이터 업데이트

이름 및/또는 설명을 업데이트합니다. 생략된 필드는 현재 값을 유지합니다.

모듈 삭제(소프트)

Idempotent - 모듈이 이미 제거된 경우에도 204를 반환합니다.

모듈 소개 가져오기

지정된 모듈의 소개 텍스트 집합을 반환합니다.

모듈 소개 설정 또는 바꾸기

Upsert - 누락된 경우 만들고 있는 경우 대체합니다.

모듈 소개 제거

Idempotent - 소개가 설정되지 않은 경우에도 204

모듈에 대한 퀴즈 질문 나열

지정된 모듈에 연결된 퀴즈 질문을 반환합니다.

모듈에 퀴즈 질문 추가

지정된 모듈 내에 새 퀴즈 질문을 만듭니다.

모듈에 항목 추가

지정된 모듈 내에 새 토픽을 만듭니다.

모듈에서 퀴즈 질문 순서 다시 지정

questionIds는 모듈에 대한 모든 활성 퀴즈 질문을 새 순서로 포함해야 합니다.

모듈에서 퀴즈 질문 하나 가져오기

지정된 모듈에 연결된 단일 퀴즈 질문을 반환합니다.

모듈에서 퀴즈 질문 하나 삭제

Idempotent — 이미 제거된 경우에도 204

모듈에서 하나의 퀴즈 질문 업데이트

저장된 형식과 일치하는 필드를 제공합니다. 관련 없는 필드는 무시됩니다.

모듈의 항목 나열

ordinalNumber로 정렬된 활성 토픽을 반환합니다.

문서 가져오기

문서 메타데이터 및 수명이 짧은 서명된 다운로드 URL을 반환합니다.

문서 나열

호출자 회사의 페이지를 매긴 문서 목록

문서 메타데이터 업데이트

이름 및/또는 설명 업데이트

문서 삭제(비활성화)

Idempotent - 문서가 이미 삭제되었거나 누락된 경우에도 204를 반환합니다.

문서 업로드

다중 파트 업로드(파일 + 선택적 설명). 최대 50MB.

문서 이진 바꾸기

기존 문서의 파일 이진 파일을 바꿉니다. 메타데이터가 유지됨

미디어 나열

호출자 회사의 페이지가 매겨진 미디어 항목 목록

미디어 메타데이터 업데이트

이름 및/또는 설명 업데이트

미디어 이진 파일 바꾸기

현재 위치에 있는 기존 미디어 항목의 파일 이진 파일을 바꿉니다. 메타데이터가 유지됨

미디어 항목 가져오기

미디어 메타데이터 및 수명이 짧은 서명된 다운로드 URL을 반환합니다.

미디어 항목 삭제(비활성화)

Idempotent - 항목이 이미 삭제되었거나 누락된 경우에도 204를 반환합니다.

미디어 항목 업로드

다중 파트 업로드(파일 + 선택적 설명). 이미지의 경우 최대 50MB, 비디오의 경우 500MB입니다.

부서 나열

중첩된 역할이 있는 호출자 회사의 모든 부서

부서 내에서 역할 만들기

지정된 부서로 범위가 지정된 새 역할을 만듭니다.

부서 만들기

호출자의 회사에 새 부서를 만듭니다.

부서 삭제(비활성화)

Idempotent는 이미 비활성화된 경우에도 204를 반환합니다. 역할 할당에 연계합니다.

부서 업데이트

이름 및/또는 설명 업데이트

비디오 처리 다시 실행

AI 구분을 위해 비디오를 다시 제출합니다. 필요에 따라 처리 프롬프트를 재정의합니다.

빈 과정 만들기

지정된 이름을 사용하여 새 과정 셸을 만듭니다.

사용자 가져오기

사용자 메타데이터 및 부서/역할 할당을 반환합니다.

사용자 다시 활성화

Idempotent - 이미 활성 상태인 경우에도 사용자를 반환합니다.

사용자 만들기

사용자를 만들고 매직 링크 초대 흐름을 트리거합니다.

사용자 목록

호출자 회사의 페이지를 매긴 사용자 목록

사용자 비활성화

Idempotent - 이미 비활성화된 경우에도 사용자를 반환합니다.

사용자 업데이트

firstName, lastName, isAdmin 및 역할 할당을 업데이트합니다. v1에서는 전자 메일을 편집할 수 없습니다.

역할에 사용자 할당

Idempotent

역할에서 사용자 할당 해제

Idempotent — 할당되지 않은 경우에도 204

연습 받기

지정된 ID에 대한 연습 세부 정보를 반환합니다.

연습 삭제

Idempotent — 이미 제거된 경우에도 204

연습 업데이트

형식 인식: ILE_TEXT 프롬프트 + generatedContent.scenario만 사용합니다. RPE_*는 모든 RPE 필드를 사용합니다. 생략된 필드는 현재 값을 유지합니다.

인증서 PDF 다운로드

인증서 PDF를 스트리밍합니다. 인증서에 아직 PDF가 없는 경우 404를 반환합니다.

인증서 세부 정보

호출자의 회사로 범위가 지정된 인증서 하나를 반환합니다.

전문가 나열

발신자 회사의 페이지를 매긴 전문가 목록

전문가 얻기

전문가 메타데이터, 연결된 문서 및 할당된 역할/부서를 반환합니다.

전문가로부터 모든 역할 할당 제거

Idempotent

전문가로부터 역할 할당 하나 제거

Idempotent

전문가에게 문서 할당

전문가에게 문서를 대량으로 연결합니다. Idempotent.

전문가에게 역할 할당

가산성 — 이미 할당된 역할이 유지됩니다. 새로 추가되었습니다. 업데이트된 전문가를 반환합니다.

전문가에게 질문하기

스트리밍 AI 채팅을 둘러싼 동기 래퍼입니다. 어셈블된 대답을 반환합니다.

전문가의 문서 할당 취소

Idempotent

주제에 대한 퀴즈 질문 순서 다시 지정

questionIds는 토픽에 대한 모든 활성 퀴즈 질문을 새 순서로 포함해야 합니다.

주제에 대한 퀴즈 질문 하나 가져오기

지정된 항목에 첨부된 단일 퀴즈 질문을 반환합니다.

주제에 퀴즈 질문 추가

지정된 항목 내에 새 퀴즈 질문을 만듭니다.

코스에서 모듈 순서 다시 지정

moduleIds는 모든 활성 모듈을 새 순서로 정확히 한 번 포함해야 합니다.

코스에서 모든 역할 할당 제거

Idempotent

코스에서 역할 할당 하나 제거

Idempotent

토픽 메타데이터 업데이트

이름 및/또는 설명을 업데이트합니다. 생략된 필드는 현재 값을 유지합니다.

토픽 삭제(소프트)

Idempotent - 항목이 이미 제거된 경우에도 204를 반환합니다.

토픽에 대한 AI 콘텐츠 생성 트리거

과정 내의 지정된 토픽에 대한 AI 콘텐츠 생성을 큐에 넣기

토픽에 대한 퀴즈 질문 하나 삭제

Idempotent — 이미 제거된 경우에도 204

토픽에 문서 연결

가산성 - 이미 연결된 문서를 건너뜁

토픽에 연결된 문서 나열

페이지를 매긴; 문서 이름별 선택적 검색

토픽에 학습 바이트 추가

지정된 항목 내에 새 학습 바이트를 만듭니다.

토픽에서 문서 한 개 연결 해제

Idempotent

토픽을 다른 모듈로 이동

targetOrdinalNumber는 선택 사항입니다. 생략하면 대상 모듈에 토픽이 추가됩니다.

하나의 질문 유형에 대한 모듈 퀴즈 수 설정

지정된 questionType(MULTIPLE_CHOICE 또는 OPEN_ENDED)의 수를 바꿉니다. 다른 형식의 개수가 유지됩니다.

하나의 질문 유형에 대한 토픽 퀴즈 수 설정

지정된 questionType(MULTIPLE_CHOICE 또는 OPEN_ENDED)의 수를 바꿉니다. 다른 형식의 개수가 유지됩니다.

학생별 인사이트

지정된 창에 대한 집계된 요약 및 과정별 분석

학생별 활동 이벤트

페이지를 매긴 전달 전용 이벤트 스트림

학생에게 가용성 설정/해제

데모 교육이 학생에게 게시되는지 여부를 설정합니다. Idempotent.

학생의 인증서 나열

호출자 회사 내에서 지정된 학생이 획득한 인증서를 반환합니다.

학습 바이트 가져오기

메타데이터 및 중첩된 단원을 반환합니다.

학습 바이트 메타데이터 업데이트

생략된 필드는 현재 값을 유지합니다.

학습 바이트 삭제(소프트)

Idempotent — 이미 제거된 경우에도 204

학습 바이트에 단원 추가

지정된 학습 바이트 내에 새 단원을 만듭니다.

학습 바이트에서 단원 나열

지정된 학습 바이트에 속하는 단원을 반환합니다.

항목 가져오기

지정된 ID에 대한 항목 세부 정보를 반환합니다.

항목 소개 가져오기

지정된 항목의 소개 텍스트 집합을 반환합니다.

항목 소개 설정 또는 바꾸기

Upsert - 누락된 경우 만들고 있는 경우 대체합니다.

항목 소개 제거

Idempotent - 소개가 설정되지 않은 경우에도 204

항목에 ILE_TEXT 연습 추가

지정된 항목 내에 새 ILE_TEXT 연습을 만듭니다.

항목에 RPE_VIDEO 연습 추가

지정된 항목 내에 새 RPE_VIDEO 역할 재생 연습을 만듭니다.

항목에 RPE_VOICE 연습 추가

지정된 항목 내에 새 RPE_VOICE 역할 재생 연습을 만듭니다.

항목에 대한 퀴즈 질문 1개 업데이트

저장된 형식과 일치하는 필드를 제공합니다. 관련 없는 필드는 무시됩니다.

항목에 대한 퀴즈 질문 나열

지정된 항목에 첨부된 퀴즈 질문을 반환합니다.

항목의 연습 나열

ordinalNumber로 정렬된 혼합 형식(ILE_TEXT/RPE_VOICE/RPE_VIDEO)

항목의 학습 바이트 나열

지정된 항목에 속하는 학습 바이트를 반환합니다.

회사 수준 인사이트

호출자 회사에 대한 최상위 KPI

AI 콘텐츠를 사용하여 전체 과정 생성

과정 셸, 모든 모듈, 모든 토픽을 만들고 모든 토픽에 대한 AI 콘텐츠 생성을 큐에 넣기

매개 변수

Name 필수 형식 Description
이름
name True string
description
description string
이름
name True string
description
description string
이름
name True string
description
description string

반품

AI를 통해 특정 항목 다시 생성

단원, 단원 질문, 퀴즈, 소개 또는 연습을 다시 생성합니다.

매개 변수

Name 필수 형식 Description
target
target True string
targetId
targetId True uuid
parentType(부모유형)
parentType string

반품

과정 가져오기

모듈 요약 및 할당된 역할/부서를 사용하여 과정 메타데이터를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

과정 게시

과정을 게시합니다. 게시할 수 있는 콘텐츠가 없으면 400으로 실패합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

과정 나열

호출자 회사의 페이지를 매긴 과정 목록

매개 변수

Name 필수 형식 Description
페이지
page integer

페이지

크기
size integer

크기

Search
search string

Search

Status
status string

Status

부서 역할 ID
departmentRoleIds string

부서 역할 ID

반품

과정 메타데이터 업데이트

과정 이름 업데이트

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

이름
name string

반품

과정 버전 나열

버전 번호에 따라 정렬된 게시된 버전 메타데이터(개수 + 게시 정보)를 반환합니다.

매개 변수

Name 필수 형식 Description
과정 ID
courseId True uuid

과정 ID

반품

과정 버전 스냅샷 가져오기

지정된 버전에 대한 전체 콘텐츠 트리(모듈, 토픽, 단원, 연습, 질문)를 반환합니다.

매개 변수

Name 필수 형식 Description
과정 ID
courseId True uuid

과정 ID

버전 번호
versionNumber True integer

버전 번호

반품

과정 삭제(소프트)

멱등원 — 과정이 이미 제거된 경우에도 204를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

과정에 대한 AI 생성 상태 가져오기

진행률 및 대상 정보가 포함된 과정에 대한 활성 AI 생성 요청 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

과정에 모듈 추가

지정된 과정 내에 새 모듈을 만듭니다.

매개 변수

Name 필수 형식 Description
과정 ID
courseId True uuid

과정 ID

이름
name True string
description
description string

반품

과정에 역할 할당

가산성 - 이미 할당된 역할은 건너뜁니다. 업데이트된 과정 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

roleIds
roleIds True array of uuid

반품

과정의 모듈 나열

ordinalNumber로 정렬된 활성 모듈을 반환합니다.

매개 변수

Name 필수 형식 Description
과정 ID
courseId True uuid

과정 ID

반품

단원 가져오기

단원 콘텐츠, 미디어 및 수업 내 질문을 반환합니다.

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

반품

단원 내 질문 나열

지정된 단원에 첨부된 지식 점검 질문을 반환합니다.

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

반품

단원 내 질문 삭제

Idempotent — 이미 제거된 경우에도 204

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

질문 ID
questionId True uuid

질문 ID

단원 내 질문 순서 다시 지정

questionIds는 수업에 대한 모든 활성 질문을 새 순서로 포함해야 합니다.

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

questionIds
questionIds True array of uuid

반품

단원 내 질문 업데이트

저장된 형식과 일치하는 필드를 제공합니다. 관련 없는 필드는 무시됩니다.

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

질문 ID
questionId True uuid

질문 ID

문자 메시지
text string
문자 메시지
text True string
isCorrect
isCorrect boolean
expectedAnswer
expectedAnswer string

반품

단원 내 질문 추가

형식은 MULTIPLE_CHOICE(옵션 필요) 또는 OPEN_ENDED

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

type
type True string
문자 메시지
text True string
ordinalNumber
ordinalNumber integer
문자 메시지
text True string
isCorrect
isCorrect boolean
expectedAnswer
expectedAnswer string

반품

단원 삭제(소프트)

Idempotent — 이미 제거된 경우에도 204

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

단원 콘텐츠 업데이트

생략된 콘텐츠는 현재 값을 유지합니다.

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

콘텐츠
content string

반품

단원에서 질문 하나 받기

해당 ID로 단원 내 단일 질문을 반환합니다.

매개 변수

Name 필수 형식 Description
단원 ID
lessonId True uuid

단원 ID

질문 ID
questionId True uuid

질문 ID

반품

데모 교육 만들기

이전에 업로드한 비디오 파일에서 데모 학습을 만들고 처리를 시작합니다.

매개 변수

Name 필수 형식 Description
이름
name True string
description
description string
trainingType
trainingType True string
비디오파일ID
videoFileId True uuid
departmentId
departmentId uuid
processingPrompt
processingPrompt string

반품

데모 교육 받기

세그먼트를 사용하여 전체 데모 학습을 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

데모 교육 업데이트

부분 업데이트입니다. 변경하려는 필드만 전달합니다. assignedRoleIds는 현재 집합을 대체합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

이름
name string
description
description string
trainingType
trainingType string
departmentId
departmentId uuid
assignedRoleIds
assignedRoleIds array of uuid

반품

데모 학습 나열

호출자의 회사로 범위가 지정된 페이지를 매긴 목록

매개 변수

Name 필수 형식 Description
페이지
page integer

페이지

크기
size integer

크기

Search
search string

Search

학습 유형
trainingTypes string

학습 유형

상태
statuses string

상태

부서 ID
departmentIds string

부서 ID

사용 가능
isAvailable boolean

사용 가능

반품

데모 학습 삭제

Idempotent - 데모 학습이 없거나 이미 사라진 경우에도 204를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

모듈 가져오기

지정된 ID에 대한 모듈 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

반품

모듈 내에서 항목 순서 다시 지정

topicIds는 모든 활성 토픽을 새 순서로 정확히 한 번 포함해야 합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

topicIds
topicIds True array of uuid

반품

모듈 메타데이터 업데이트

이름 및/또는 설명을 업데이트합니다. 생략된 필드는 현재 값을 유지합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

이름
name string
description
description string

반품

모듈 삭제(소프트)

Idempotent - 모듈이 이미 제거된 경우에도 204를 반환합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

모듈 소개 가져오기

지정된 모듈의 소개 텍스트 집합을 반환합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

반품

IntroDto

모듈 소개 설정 또는 바꾸기

Upsert - 누락된 경우 만들고 있는 경우 대체합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

소개
introduction string

반품

IntroDto

모듈 소개 제거

Idempotent - 소개가 설정되지 않은 경우에도 204

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

모듈에 대한 퀴즈 질문 나열

지정된 모듈에 연결된 퀴즈 질문을 반환합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

반품

모듈에 퀴즈 질문 추가

지정된 모듈 내에 새 퀴즈 질문을 만듭니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

type
type True string
문자 메시지
text True string
ordinalNumber
ordinalNumber integer
문자 메시지
text True string
isCorrect
isCorrect boolean
expectedAnswer
expectedAnswer string

반품

모듈에 항목 추가

지정된 모듈 내에 새 토픽을 만듭니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

이름
name True string
description
description string

반품

TopicDto

모듈에서 퀴즈 질문 순서 다시 지정

questionIds는 모듈에 대한 모든 활성 퀴즈 질문을 새 순서로 포함해야 합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

questionIds
questionIds True array of uuid

반품

모듈에서 퀴즈 질문 하나 가져오기

지정된 모듈에 연결된 단일 퀴즈 질문을 반환합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

질문 ID
questionId True uuid

질문 ID

반품

모듈에서 퀴즈 질문 하나 삭제

Idempotent — 이미 제거된 경우에도 204

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

질문 ID
questionId True uuid

질문 ID

모듈에서 하나의 퀴즈 질문 업데이트

저장된 형식과 일치하는 필드를 제공합니다. 관련 없는 필드는 무시됩니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

질문 ID
questionId True uuid

질문 ID

문자 메시지
text string
문자 메시지
text True string
isCorrect
isCorrect boolean
expectedAnswer
expectedAnswer string

반품

모듈의 항목 나열

ordinalNumber로 정렬된 활성 토픽을 반환합니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

반품

문서 가져오기

문서 메타데이터 및 수명이 짧은 서명된 다운로드 URL을 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

문서 나열

호출자 회사의 페이지를 매긴 문서 목록

매개 변수

Name 필수 형식 Description
페이지
page integer

페이지

크기
size integer

크기

Search
search string

Search

Mime 형식
mimeTypes string

Mime 형식

Status
status string

Status

반품

문서 메타데이터 업데이트

이름 및/또는 설명 업데이트

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

이름
name string
description
description string

반품

문서 삭제(비활성화)

Idempotent - 문서가 이미 삭제되었거나 누락된 경우에도 204를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

문서 업로드

다중 파트 업로드(파일 + 선택적 설명). 최대 50MB.

매개 변수

Name 필수 형식 Description
파일
file True file

파일

Description
description string

Description

반품

문서 이진 바꾸기

기존 문서의 파일 이진 파일을 바꿉니다. 메타데이터가 유지됨

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

파일
file True file

파일

반품

미디어 나열

호출자 회사의 페이지가 매겨진 미디어 항목 목록

매개 변수

Name 필수 형식 Description
페이지
page integer

페이지

크기
size integer

크기

Search
search string

Search

Kind
kind string

Kind

Status
status string

Status

반품

미디어 메타데이터 업데이트

이름 및/또는 설명 업데이트

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

이름
name string
description
description string

반품

미디어 이진 파일 바꾸기

현재 위치에 있는 기존 미디어 항목의 파일 이진 파일을 바꿉니다. 메타데이터가 유지됨

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

파일
file True file

파일

반품

미디어 항목 가져오기

미디어 메타데이터 및 수명이 짧은 서명된 다운로드 URL을 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

미디어 항목 삭제(비활성화)

Idempotent - 항목이 이미 삭제되었거나 누락된 경우에도 204를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

미디어 항목 업로드

다중 파트 업로드(파일 + 선택적 설명). 이미지의 경우 최대 50MB, 비디오의 경우 500MB입니다.

매개 변수

Name 필수 형식 Description
파일
file True file

파일

Description
description string

Description

반품

부서 나열

중첩된 역할이 있는 호출자 회사의 모든 부서

반품

부서 내에서 역할 만들기

지정된 부서로 범위가 지정된 새 역할을 만듭니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

이름
name True string
전체 이름
fullName string
description
description string

반품

부서 만들기

호출자의 회사에 새 부서를 만듭니다.

매개 변수

Name 필수 형식 Description
이름
name True string
description
description string

반품

부서 삭제(비활성화)

Idempotent는 이미 비활성화된 경우에도 204를 반환합니다. 역할 할당에 연계합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

부서 업데이트

이름 및/또는 설명 업데이트

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

이름
name string
description
description string

반품

비디오 처리 다시 실행

AI 구분을 위해 비디오를 다시 제출합니다. 필요에 따라 처리 프롬프트를 재정의합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

processingPrompt
processingPrompt string

반품

빈 과정 만들기

지정된 이름을 사용하여 새 과정 셸을 만듭니다.

매개 변수

Name 필수 형식 Description
이름
name True string

반품

사용자 가져오기

사용자 메타데이터 및 부서/역할 할당을 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

UserDto

사용자 다시 활성화

Idempotent - 이미 활성 상태인 경우에도 사용자를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

UserDto

사용자 만들기

사용자를 만들고 매직 링크 초대 흐름을 트리거합니다.

매개 변수

Name 필수 형식 Description
email
email True email
firstName
firstName string
lastName
lastName string
isAdmin
isAdmin boolean
departmentRoleIds
departmentRoleIds array of uuid

반품

UserDto

사용자 목록

호출자 회사의 페이지를 매긴 사용자 목록

매개 변수

Name 필수 형식 Description
페이지
page integer

페이지

크기
size integer

크기

Search
search string

Search

Status
status string

Status

부서 ID
departmentIds string

부서 ID

역할 ID
roleIds string

역할 ID

Kind
kind string

Kind

반품

사용자 비활성화

Idempotent - 이미 비활성화된 경우에도 사용자를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

UserDto

사용자 업데이트

firstName, lastName, isAdmin 및 역할 할당을 업데이트합니다. v1에서는 전자 메일을 편집할 수 없습니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

firstName
firstName string
lastName
lastName string
isAdmin
isAdmin boolean
departmentRoleIds
departmentRoleIds array of uuid

반품

UserDto

역할에 사용자 할당

Idempotent

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

역할 ID
roleId True uuid

역할 ID

userId
userId True uuid

반품

역할에서 사용자 할당 해제

Idempotent — 할당되지 않은 경우에도 204

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

역할 ID
roleId True uuid

역할 ID

사용자 ID
userId True uuid

사용자 ID

연습 받기

지정된 ID에 대한 연습 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

연습 삭제

Idempotent — 이미 제거된 경우에도 204

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

연습 업데이트

형식 인식: ILE_TEXT 프롬프트 + generatedContent.scenario만 사용합니다. RPE_*는 모든 RPE 필드를 사용합니다. 생략된 필드는 현재 값을 유지합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

프롬프트
prompt string
avatarPictureId
avatarPictureId uuid
avatarCharacteristics
avatarCharacteristics string
reverseRolePlayEnabled
reverseRolePlayEnabled boolean
reverseRolePlayMandatory
reverseRolePlayMandatory boolean
시나리오
scenario string
traineeRole
traineeRole string
avatarName
avatarName string
avatarDescription
avatarDescription string
operationalChallenge
operationalChallenge string
successMetric
successMetric string

반품

인증서 PDF 다운로드

인증서 PDF를 스트리밍합니다. 인증서에 아직 PDF가 없는 경우 404를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

인증서 세부 정보

호출자의 회사로 범위가 지정된 인증서 하나를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

전문가 나열

발신자 회사의 페이지를 매긴 전문가 목록

매개 변수

Name 필수 형식 Description
페이지
page integer

페이지

크기
size integer

크기

Search
search string

Search

반품

전문가 얻기

전문가 메타데이터, 연결된 문서 및 할당된 역할/부서를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

반품

전문가로부터 모든 역할 할당 제거

Idempotent

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

전문가로부터 역할 할당 하나 제거

Idempotent

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

역할 ID
roleId True uuid

역할 ID

전문가에게 문서 할당

전문가에게 문서를 대량으로 연결합니다. Idempotent.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

documentIds
documentIds True array of uuid

반품

전문가에게 역할 할당

가산성 — 이미 할당된 역할이 유지됩니다. 새로 추가되었습니다. 업데이트된 전문가를 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

roleIds
roleIds True array of uuid

반품

전문가에게 질문하기

스트리밍 AI 채팅을 둘러싼 동기 래퍼입니다. 어셈블된 대답을 반환합니다.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

질문
question True string

반품

전문가의 문서 할당 취소

Idempotent

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

문서 ID
documentId True uuid

문서 ID

주제에 대한 퀴즈 질문 순서 다시 지정

questionIds는 토픽에 대한 모든 활성 퀴즈 질문을 새 순서로 포함해야 합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

questionIds
questionIds True array of uuid

반품

주제에 대한 퀴즈 질문 하나 가져오기

지정된 항목에 첨부된 단일 퀴즈 질문을 반환합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

질문 ID
questionId True uuid

질문 ID

반품

주제에 퀴즈 질문 추가

지정된 항목 내에 새 퀴즈 질문을 만듭니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

type
type True string
문자 메시지
text True string
ordinalNumber
ordinalNumber integer
문자 메시지
text True string
isCorrect
isCorrect boolean
expectedAnswer
expectedAnswer string

반품

코스에서 모듈 순서 다시 지정

moduleIds는 모든 활성 모듈을 새 순서로 정확히 한 번 포함해야 합니다.

매개 변수

Name 필수 형식 Description
과정 ID
courseId True uuid

과정 ID

moduleIds
moduleIds True array of uuid

반품

코스에서 모든 역할 할당 제거

Idempotent

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

코스에서 역할 할당 하나 제거

Idempotent

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

역할 ID
roleId True uuid

역할 ID

토픽 메타데이터 업데이트

이름 및/또는 설명을 업데이트합니다. 생략된 필드는 현재 값을 유지합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

이름
name string
description
description string

반품

TopicDto

토픽 삭제(소프트)

Idempotent - 항목이 이미 제거된 경우에도 204를 반환합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

토픽에 대한 AI 콘텐츠 생성 트리거

과정 내의 지정된 토픽에 대한 AI 콘텐츠 생성을 큐에 넣기

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

topicIds
topicIds True array of uuid

반품

토픽에 대한 퀴즈 질문 하나 삭제

Idempotent — 이미 제거된 경우에도 204

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

질문 ID
questionId True uuid

질문 ID

토픽에 문서 연결

가산성 - 이미 연결된 문서를 건너뜁

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

documentIds
documentIds True array of uuid

토픽에 연결된 문서 나열

페이지를 매긴; 문서 이름별 선택적 검색

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

페이지
page integer

페이지

크기
size integer

크기

Search
search string

Search

반품

토픽에 학습 바이트 추가

지정된 항목 내에 새 학습 바이트를 만듭니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

이름
name True string
description
description string

반품

토픽에서 문서 한 개 연결 해제

Idempotent

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

문서 ID
documentId True uuid

문서 ID

토픽을 다른 모듈로 이동

targetOrdinalNumber는 선택 사항입니다. 생략하면 대상 모듈에 토픽이 추가됩니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

targetModuleId
targetModuleId True uuid
targetOrdinalNumber
targetOrdinalNumber integer

반품

TopicDto

하나의 질문 유형에 대한 모듈 퀴즈 수 설정

지정된 questionType(MULTIPLE_CHOICE 또는 OPEN_ENDED)의 수를 바꿉니다. 다른 형식의 개수가 유지됩니다.

매개 변수

Name 필수 형식 Description
모듈 ID
moduleId True uuid

모듈 ID

questionType
questionType True string
개수
count integer

반품

하나의 질문 유형에 대한 토픽 퀴즈 수 설정

지정된 questionType(MULTIPLE_CHOICE 또는 OPEN_ENDED)의 수를 바꿉니다. 다른 형식의 개수가 유지됩니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

questionType
questionType True string
개수
count integer

반품

TopicDto

학생별 인사이트

지정된 창에 대한 집계된 요약 및 과정별 분석

매개 변수

Name 필수 형식 Description
사용자 ID
userId True uuid

사용자 ID

window string

반품

학생별 활동 이벤트

페이지를 매긴 전달 전용 이벤트 스트림

매개 변수

Name 필수 형식 Description
사용자 ID
userId True uuid

사용자 ID

페이지
page integer

페이지

크기
size integer

크기

반품

학생에게 가용성 설정/해제

데모 교육이 학생에게 게시되는지 여부를 설정합니다. Idempotent.

매개 변수

Name 필수 형식 Description
Id
id True uuid

Id

available
available True boolean

반품

학생의 인증서 나열

호출자 회사 내에서 지정된 학생이 획득한 인증서를 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
userId True uuid

사용자 ID

반품

학습 바이트 가져오기

메타데이터 및 중첩된 단원을 반환합니다.

매개 변수

Name 필수 형식 Description
Lb Id
lbId True uuid

Lb Id

반품

학습 바이트 메타데이터 업데이트

생략된 필드는 현재 값을 유지합니다.

매개 변수

Name 필수 형식 Description
Lb Id
lbId True uuid

Lb Id

이름
name string
description
description string

반품

학습 바이트 삭제(소프트)

Idempotent — 이미 제거된 경우에도 204

매개 변수

Name 필수 형식 Description
Lb Id
lbId True uuid

Lb Id

학습 바이트에 단원 추가

지정된 학습 바이트 내에 새 단원을 만듭니다.

매개 변수

Name 필수 형식 Description
Lb Id
lbId True uuid

Lb Id

콘텐츠
content True string

반품

학습 바이트에서 단원 나열

지정된 학습 바이트에 속하는 단원을 반환합니다.

매개 변수

Name 필수 형식 Description
Lb Id
lbId True uuid

Lb Id

반품

항목 가져오기

지정된 ID에 대한 항목 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

반품

TopicDto

항목 소개 가져오기

지정된 항목의 소개 텍스트 집합을 반환합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

반품

IntroDto

항목 소개 설정 또는 바꾸기

Upsert - 누락된 경우 만들고 있는 경우 대체합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

소개
introduction string

반품

IntroDto

항목 소개 제거

Idempotent - 소개가 설정되지 않은 경우에도 204

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

항목에 ILE_TEXT 연습 추가

지정된 항목 내에 새 ILE_TEXT 연습을 만듭니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

프롬프트
prompt string

반품

항목에 RPE_VIDEO 연습 추가

지정된 항목 내에 새 RPE_VIDEO 역할 재생 연습을 만듭니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

프롬프트
prompt string
avatarPictureId
avatarPictureId uuid
avatarCharacteristics
avatarCharacteristics string
reverseRolePlayEnabled
reverseRolePlayEnabled boolean
reverseRolePlayMandatory
reverseRolePlayMandatory boolean

반품

항목에 RPE_VOICE 연습 추가

지정된 항목 내에 새 RPE_VOICE 역할 재생 연습을 만듭니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

프롬프트
prompt string
avatarPictureId
avatarPictureId uuid
avatarCharacteristics
avatarCharacteristics string
reverseRolePlayEnabled
reverseRolePlayEnabled boolean
reverseRolePlayMandatory
reverseRolePlayMandatory boolean

반품

항목에 대한 퀴즈 질문 1개 업데이트

저장된 형식과 일치하는 필드를 제공합니다. 관련 없는 필드는 무시됩니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

질문 ID
questionId True uuid

질문 ID

문자 메시지
text string
문자 메시지
text True string
isCorrect
isCorrect boolean
expectedAnswer
expectedAnswer string

반품

항목에 대한 퀴즈 질문 나열

지정된 항목에 첨부된 퀴즈 질문을 반환합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

반품

항목의 연습 나열

ordinalNumber로 정렬된 혼합 형식(ILE_TEXT/RPE_VOICE/RPE_VIDEO)

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

반품

항목의 학습 바이트 나열

지정된 항목에 속하는 학습 바이트를 반환합니다.

매개 변수

Name 필수 형식 Description
토픽 ID
topicId True uuid

토픽 ID

반품

회사 수준 인사이트

호출자 회사에 대한 최상위 KPI

반품

정의

QuizSettingDto

Name 경로 형식 Description
questionType
questionType string
개수
count integer

TopicDto

Name 경로 형식 Description
id
id uuid
moduleId
moduleId uuid
이름
name string
description
description string
ordinalNumber
ordinalNumber integer
hasContent
hasContent boolean
quizSettings
quizSettings array of QuizSettingDto

IntroDto

Name 경로 형식 Description
id
id uuid
구성 요소 ID
componentId uuid
componentType
componentType string
소개
introduction string
source
source string
createdAt
createdAt date-time
updatedAt
updatedAt date-time

ModuleDetailDto

Name 경로 형식 Description
id
id uuid
courseId
courseId uuid
이름
name string
description
description string
productId
productId uuid
ordinalNumber
ordinalNumber integer
lockedForGeneration
lockedForGeneration boolean
quizSettings
quizSettings array of QuizSettingDto
topics
topics array of TopicDto

MediaDetailDto

Name 경로 형식 Description
id
id uuid
이름
name string
description
description string
kind
kind string
마임 타입
mimeType string
sizeBytes
sizeBytes integer
상태
status string
processingStatus
processingStatus string
createdAt
createdAt date-time
uploadedBy
uploadedBy UploadedByDto
다운로드URL
downloadUrl string

UploadedByDto

Name 경로 형식 Description
id
id uuid
kind
kind string
이름
name string

DocumentDetailDto

Name 경로 형식 Description
id
id uuid
이름
name string
description
description string
마임 타입
mimeType string
sizeBytes
sizeBytes integer
상태
status string
createdAt
createdAt date-time
uploadedBy
uploadedBy UploadedByDto
다운로드URL
downloadUrl string

DepartmentRoleDto

Name 경로 형식 Description
departmentId
departmentId uuid
부서명
departmentName string
롤ID
roleId uuid
roleName(역할 이름)
roleName string

UserDto

Name 경로 형식 Description
id
id uuid
email
email string
firstName
firstName string
lastName
lastName string
상태
status string
kind
kind string
isAdmin
isAdmin boolean
createdAt
createdAt date-time
departmentRoles
departmentRoles array of DepartmentRoleDto

QuestionDto

Name 경로 형식 Description
id
id uuid
type
type string
부모 ID
parentId uuid
parentType(부모유형)
parentType string
문자 메시지
text string
ordinalNumber
ordinalNumber integer
source
source string
expectedAnswer
expectedAnswer string
options
options array of QuestionOptionDto
createdAt
createdAt date-time
updatedAt
updatedAt date-time

QuestionOptionDto

Name 경로 형식 Description
문자 메시지
text string
isCorrect
isCorrect boolean
ordinalNumber
ordinalNumber integer

QuestionListResponse

Name 경로 형식 Description
items
items array of QuestionDto

LearningByteDetailDto

Name 경로 형식 Description
id
id uuid
topicId
topicId uuid
이름
name string
description
description string
ordinalNumber
ordinalNumber integer
source
source string
createdAt
createdAt date-time
updatedAt
updatedAt date-time
단원
lessons array of LessonDto

LessonDto

Name 경로 형식 Description
id
id uuid
learningByteId
learningByteId uuid
콘텐츠
content string
ordinalNumber
ordinalNumber integer
source
source string
questionCount
questionCount integer
mediaCount
mediaCount integer
createdAt
createdAt date-time
updatedAt
updatedAt date-time

ExerciseDto

Name 경로 형식 Description
id
id uuid
topicId
topicId uuid
type
type string
프롬프트
prompt string
ordinalNumber
ordinalNumber integer
source
source string
isGenerated
isGenerated boolean
avatarPictureId
avatarPictureId uuid
avatarCharacteristics
avatarCharacteristics string
reverseRolePlayEnabled
reverseRolePlayEnabled boolean
reverseRolePlayMandatory
reverseRolePlayMandatory boolean
generatedContent
generatedContent ExerciseGeneratedContentDto
createdAt
createdAt date-time
updatedAt
updatedAt date-time

ExerciseGeneratedContentDto

Name 경로 형식 Description
id
id uuid
regenerationId
regenerationId uuid
시나리오
scenario string
traineeRole
traineeRole string
avatarName
avatarName string
avatarDescription
avatarDescription string
operationalChallenge
operationalChallenge string
successMetric
successMetric string
명령
instruction string
instructionReverse
instructionReverse string
exerciseKnowledgeBase
exerciseKnowledgeBase string
topicKnowledgeBase
topicKnowledgeBase string

TopicListResponse

Name 경로 형식 Description
items
items array of TopicDto

LessonDetailDto

Name 경로 형식 Description
id
id uuid
learningByteId
learningByteId uuid
콘텐츠
content string
ordinalNumber
ordinalNumber integer
source
source string
createdAt
createdAt date-time
updatedAt
updatedAt date-time
미디어
media array of MediaLinkDto
질문
questions array of QuestionDto

MediaLinkDto

Name 경로 형식 Description
id
id uuid
fileId
fileId uuid
ordinalNumber
ordinalNumber integer
source
source string

ExpertDetailDto

Name 경로 형식 Description
id
id uuid
이름
name string
description
description string
상태
status string
linkedDocumentCount
linkedDocumentCount integer
createdAt
createdAt date-time
updatedAt
updatedAt date-time
assignedRoleIds
assignedRoleIds array of uuid
assignedDepartmentIds
assignedDepartmentIds array of uuid
linkedDocuments
linkedDocuments array of LinkedDocumentDto

LinkedDocumentDto

Name 경로 형식 Description
id
id uuid
이름
name string
확장
extension string
sizeBytes
sizeBytes integer
description
description string
linkedAt
linkedAt date-time

AskResponse

Name 경로 형식 Description
대답
answer string
durationMs
durationMs integer

DepartmentDto

Name 경로 형식 Description
id
id uuid
이름
name string
description
description string
상태
status string
createdAt
createdAt date-time
roles
roles array of DepartmentRoleDto

DemoTrainingDto

Name 경로 형식 Description
id
id uuid
companyId
companyId uuid
departmentId
departmentId uuid
이름
name string
description
description string
trainingType
trainingType string
상태
status string
사용 가능 여부
isAvailable boolean
비디오파일ID
videoFileId uuid
processingPrompt
processingPrompt string
errorMessage
errorMessage string
assignedRoleIds
assignedRoleIds array of uuid
세그먼트
segments array of DemoTrainingSegmentDto
createdAt
createdAt date-time
updatedAt
updatedAt date-time

DemoTrainingSegmentDto

Name 경로 형식 Description
id
id uuid
ordinalNumber
ordinalNumber integer
이름
name string
사본
transcript string
durationSeconds
durationSeconds integer

CourseDetailDto

Name 경로 형식 Description
id
id uuid
이름
name string
상태
status string
moduleCount
moduleCount integer
topicCount
topicCount integer
hasUnpublishedChanges
hasUnpublishedChanges boolean
currentVersionNumber
currentVersionNumber integer
createdAt
createdAt date-time
updatedAt
updatedAt date-time
assignedRoleIds
assignedRoleIds array of uuid
assignedDepartmentIds
assignedDepartmentIds array of uuid
modules
modules array of ModuleSummaryDto

ModuleSummaryDto

Name 경로 형식 Description
id
id uuid
이름
name string
ordinalNumber
ordinalNumber integer
topicCount
topicCount integer

GenerationRequestResponse

Name 경로 형식 Description
id
id uuid
상태
status string

ModuleDto

Name 경로 형식 Description
id
id uuid
courseId
courseId uuid
이름
name string
description
description string
productId
productId uuid
ordinalNumber
ordinalNumber integer
lockedForGeneration
lockedForGeneration boolean
topicCount
topicCount integer
quizSettings
quizSettings array of QuizSettingDto

ModuleListResponse

Name 경로 형식 Description
items
items array of ModuleDto

GenerateCourseResponse

Name 경로 형식 Description
courseId
courseId uuid
generationRequestId
generationRequestId uuid

PageInfo

Name 경로 형식 Description
size
size integer
number
number integer
totalElements
totalElements integer
총 페이지 수
totalPages integer

UserListResponse

Name 경로 형식 Description
items
items array of UserDto
페이지
page PageInfo

TopicLinkedDocumentDto

Name 경로 형식 Description
id
id uuid
이름
name string
확장
extension string
size
size integer
processingStatus
processingStatus string
description
description string
source
source string
linkType
linkType string
linkedAt
linkedAt date-time

TopicLinkedDocumentListResponse

Name 경로 형식 Description
items
items array of TopicLinkedDocumentDto
페이지
page PageInfo

LearningByteDto

Name 경로 형식 Description
id
id uuid
topicId
topicId uuid
이름
name string
description
description string
ordinalNumber
ordinalNumber integer
source
source string
lessonCount
lessonCount integer
createdAt
createdAt date-time
updatedAt
updatedAt date-time

LearningByteListResponse

Name 경로 형식 Description
items
items array of LearningByteDto

ExerciseListResponse

Name 경로 형식 Description
items
items array of ExerciseDto

CertificateDto

Name 경로 형식 Description
id
id uuid
등록ID
enrollmentId uuid
studentId
studentId uuid
companyId
companyId uuid
courseId
courseId uuid
courseVersionId
courseVersionId uuid
studentName
studentName string
companyName
companyName string
courseName
courseName string
serialNumber
serialNumber string
completedAt
completedAt date-time
발행됨
issuedAt date-time
pdfFileId
pdfFileId uuid
pdfAvailable
pdfAvailable boolean

CertificateListResponse

Name 경로 형식 Description
items
items array of CertificateDto

MediaDto

Name 경로 형식 Description
id
id uuid
이름
name string
description
description string
kind
kind string
마임 타입
mimeType string
sizeBytes
sizeBytes integer
상태
status string
processingStatus
processingStatus string
createdAt
createdAt date-time
uploadedBy
uploadedBy UploadedByDto

MediaListResponse

Name 경로 형식 Description
items
items array of MediaDto
페이지
page PageInfo

LessonListResponse

Name 경로 형식 Description
items
items array of LessonDto

CourseBreakdownDto

Name 경로 형식 Description
courseId
courseId uuid
courseName
courseName string
progressPercent
progressPercent integer
hoursSpent
hoursSpent double
startedAt
startedAt date-time
completedAt
completedAt date-time

StudentInsightsDto

Name 경로 형식 Description
userId
userId uuid
window WindowDto
summary
summary StudentSummaryDto
byCourse
byCourse array of CourseBreakdownDto

StudentSummaryDto

Name 경로 형식 Description
activeDays
activeDays integer
lessonsCompleted
lessonsCompleted integer
exercisesCompleted
exercisesCompleted integer
퀴즈패스
quizzesPassed integer
hoursSpent
hoursSpent double

WindowDto

Name 경로 형식 Description
kind
kind string
부터
from date-time
to
to date-time

EventItemDto

Name 경로 형식 Description
id
id uuid
kind
kind string
action
action string
courseId
courseId uuid
courseName
courseName string
occurredAt
occurredAt date-time

EventListResponse

Name 경로 형식 Description
items
items array of EventItemDto
페이지
page PageInfo

CompanyInsightsDto

Name 경로 형식 Description
companyId
companyId uuid
summary
summary CompanySummaryDto

CompanySummaryDto

Name 경로 형식 Description
totalStudents
totalStudents integer
averageProgressPercent
averageProgressPercent integer
activeThisWeekCount
activeThisWeekCount integer
completedCount
completedCount integer
completionRatePercent
completionRatePercent integer

ExpertDto

Name 경로 형식 Description
id
id uuid
이름
name string
description
description string
상태
status string
linkedDocumentCount
linkedDocumentCount integer
createdAt
createdAt date-time
updatedAt
updatedAt date-time

ExpertListResponse

Name 경로 형식 Description
items
items array of ExpertDto
페이지
page PageInfo

DocumentDto

Name 경로 형식 Description
id
id uuid
이름
name string
description
description string
마임 타입
mimeType string
sizeBytes
sizeBytes integer
상태
status string
createdAt
createdAt date-time
uploadedBy
uploadedBy UploadedByDto

DocumentListResponse

Name 경로 형식 Description
items
items array of DocumentDto
페이지
page PageInfo

DepartmentListResponse

Name 경로 형식 Description
items
items array of DepartmentDto

DemoTrainingListItemDto

Name 경로 형식 Description
id
id uuid
departmentId
departmentId uuid
비디오파일ID
videoFileId uuid
이름
name string
description
description string
trainingType
trainingType string
상태
status string
사용 가능 여부
isAvailable boolean
assignedRoleIds
assignedRoleIds array of uuid
segmentCount
segmentCount integer
durationSeconds
durationSeconds integer
createdAt
createdAt date-time

DemoTrainingListResponse

Name 경로 형식 Description
items
items array of DemoTrainingListItemDto
페이지
page PageInfo

CourseDto

Name 경로 형식 Description
id
id uuid
이름
name string
상태
status string
moduleCount
moduleCount integer
topicCount
topicCount integer
hasUnpublishedChanges
hasUnpublishedChanges boolean
currentVersionNumber
currentVersionNumber integer
latestPublishedAt
latestPublishedAt date-time
createdAt
createdAt date-time

CourseListResponse

Name 경로 형식 Description
items
items array of CourseDto
페이지
page PageInfo

GenerationProgressDto

Name 경로 형식 Description
totalTasks
totalTasks integer
completedTasks
completedTasks integer
failedTasks
failedTasks integer

GenerationRequestInfoDto

Name 경로 형식 Description
id
id uuid
상태
status string
createdAt
createdAt string
completedAt
completedAt string
오류
error string
발전
progress GenerationProgressDto
target
target string
targetId
targetId uuid
parentType(부모유형)
parentType string
topicIds
topicIds array of uuid
moduleIds
moduleIds array of uuid

GenerationStatusResponse

Name 경로 형식 Description
activeRequests
activeRequests array of GenerationRequestInfoDto

CourseVersionDto

Name 경로 형식 Description
id
id uuid
courseId
courseId uuid
versionNumber
versionNumber integer
publishedAt
publishedAt date-time
publishedBy
publishedBy uuid
moduleCount
moduleCount integer
topicCount
topicCount integer
lessonCount
lessonCount integer
exerciseCount
exerciseCount integer
questionCount
questionCount integer
estimatedTimeSeconds
estimatedTimeSeconds integer

CourseVersionListResponse

Name 경로 형식 Description
items
items array of CourseVersionDto

AuditSnapshot

Name 경로 형식 Description
createdAt
createdAt date-time
작성자
createdBy uuid
updatedAt
updatedAt date-time
업데이트작성자:
updatedBy uuid

CourseSnapshot

Name 경로 형식 Description
이름
name string
coverImageId
coverImageId uuid
prerequisiteCourseId
prerequisiteCourseId uuid
courseGuideline
courseGuideline string
lessonsGuideline
lessonsGuideline string
questionsGuideline
questionsGuideline string
exercisesGuideline
exercisesGuideline string
modules
modules array of ModuleSnapshot

CourseVersionSnapshotDto

Name 경로 형식 Description
id
id uuid
courseId
courseId uuid
versionNumber
versionNumber integer
snapshot
snapshot CourseSnapshot

ExerciseSnapshot

Name 경로 형식 Description
id
id uuid
topicId
topicId uuid
exerciseType
exerciseType string
프롬프트
prompt string
ordinalNumber
ordinalNumber integer
isGenerated
isGenerated boolean
source
source string
감사
audit AuditSnapshot
avatarCharacteristics
avatarCharacteristics string
avatarPictureId
avatarPictureId uuid
reverseRolePlayEnabled
reverseRolePlayEnabled boolean
reverseRolePlayMandatory
reverseRolePlayMandatory boolean
시나리오
scenario string
traineeRole
traineeRole string
avatarName
avatarName string
avatarDescription
avatarDescription string
operationalChallenge
operationalChallenge string
successMetric
successMetric string
명령
instruction string
instructionReverse
instructionReverse string
exerciseKnowledgeBase
exerciseKnowledgeBase string

LearningByteSnapshot

Name 경로 형식 Description
id
id uuid
topicId
topicId uuid
이름
name string
description
description string
ordinalNumber
ordinalNumber integer
source
source string
감사
audit AuditSnapshot
단원
lessons array of LessonSnapshot

LessonSnapshot

Name 경로 형식 Description
id
id uuid
learningByteId
learningByteId uuid
콘텐츠
content string
ordinalNumber
ordinalNumber integer
source
source string
감사
audit AuditSnapshot
미디어
media array of MediaSnapshot
질문
questions array of QuestionSnapshot

LinkedDocumentSnapshot

Name 경로 형식 Description
id
id uuid
fileId
fileId uuid
linkType
linkType string
isSupplement
isSupplement boolean
이름
name string
확장
extension string
size
size integer
description
description string

MediaSnapshot

Name 경로 형식 Description
id
id uuid
fileId
fileId uuid
ordinalNumber
ordinalNumber integer
mediaType
mediaType string
source
source string

ModuleSnapshot

Name 경로 형식 Description
id
id uuid
courseId
courseId uuid
productId
productId uuid
이름
name string
description
description string
소개
intro string
ordinalNumber
ordinalNumber integer
quizSettings
quizSettings array of QuizSettingSnapshot
quizQuestions
quizQuestions array of QuestionSnapshot
topics
topics array of TopicSnapshot

OptionSnapshot

Name 경로 형식 Description
id
id uuid
optionText
optionText string
isCorrect
isCorrect boolean
ordinalNumber
ordinalNumber integer

QuestionSnapshot

Name 경로 형식 Description
id
id uuid
questionType
questionType string
questionText
questionText string
expectedAnswer
expectedAnswer string
ordinalNumber
ordinalNumber integer
source
source string
감사
audit AuditSnapshot
options
options array of OptionSnapshot

QuizSettingSnapshot

Name 경로 형식 Description
questionType
questionType string
개수
count integer

TopicSnapshot

Name 경로 형식 Description
id
id uuid
moduleId
moduleId uuid
이름
name string
description
description string
소개
intro string
ordinalNumber
ordinalNumber integer
quizSettings
quizSettings array of QuizSettingSnapshot
quizQuestions
quizQuestions array of QuestionSnapshot
learningBytes
learningBytes array of LearningByteSnapshot
연습
exercises array of ExerciseSnapshot
linkedDocuments
linkedDocuments array of LinkedDocumentSnapshot
topicKnowledgeBase
topicKnowledgeBase string

StreamingResponseBody