녹화
녹화, 스크립트, 공유 링크를 위한 엔드포인트입니다. 모든 경로는 https://api.recordmeeting.com에 있으며 API 키가 필요합니다. 인증을 참조하세요.
녹화 목록 조회
섹션 제목: “녹화 목록 조회”GET /v1/recordings액세스할 수 있는 녹화의 페이지별 목록을 반환합니다.
쿼리 매개변수
섹션 제목: “쿼리 매개변수”| 매개변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
limit | 정수 | 20 | 결과 수(1~100) |
offset | 정수 | 0 | 페이지네이션 오프셋 |
search | 문자열 | 없음 | 제목의 텍스트로 필터링 |
status | 문자열 | 없음 | 상태로 필터링(녹화 상태 참조) |
date_from | 문자열 | 없음 | ISO 8601 날짜 및 시간. 해당 시각 이후에 생성된 녹화만 |
date_to | 문자열 | 없음 | ISO 8601 날짜 및 시간. 해당 시각 이전에 생성된 녹화만 |
organization_id | 문자열 | 없음 | 조직의 녹화 목록 조회 |
folder_id | 문자열 | 없음 | 폴더의 녹화 목록 조회 |
user_id | 문자열 | 없음 | 사용자로 필터링. 한 구성원의 녹화를 원하는 조직 관리자용 |
{ "data": [ { "id": "uuid", "title": "Weekly sync", "status": "COMPLETED", "created_at": "2026-09-19T15:00:00.000Z", "duration_seconds": 1740, "thumbnail_url": "https://...", "folder_id": null, "organization_id": null, "transcription_status": "completed", "notes_status": "completed", "is_shared": true, "processing_progress": null } ], "pagination": { "total": 42, "limit": 20, "offset": 0, "has_more": true }}title, duration_seconds, thumbnail_url, folder_id, organization_id, transcription_status, notes_status 및 processing_progress는 null일 수 있습니다. 잠긴 녹화의 경우 transcription_status와 notes_status가 null입니다.
organization_id를 사용하면 편집자와 뷰어는 볼 수 있는 권한이 있는 녹화만 받습니다. 이때 total은 상한이며, 페이지에는 limit보다 적은 항목이 포함될 수 있습니다.
오류: 400 VALIDATION_ERROR, 해당 조직의 녹화를 나열할 수 없는 경우 403 FORBIDDEN.
녹화 상세 조회
섹션 제목: “녹화 상세 조회”GET /v1/recordings/:id한 녹화의 전체 세부 정보를 반환합니다.
조직 녹화는 해당 녹화를 볼 수 있는 구성원이면 누구에게나 반환됩니다. 소유자와 관리자는 조직의 모든 녹화를 열 수 있습니다. 편집자와 뷰어는 자신의 역할과 폴더가 허용하는 범위의 녹화를 봅니다. 조직 녹화의 경우 is_locked, download_url, capabilities는 개인 요금제가 아니라 조직의 요금제와 구성원의 기능 액세스 권한을 따릅니다.
{ "data": { "id": "uuid", "title": "Weekly sync", "status": "COMPLETED", "created_at": "2026-09-19T15:00:00.000Z", "updated_at": "2026-09-19T15:30:00.000Z", "started_at": "2026-09-19T15:01:00.000Z", "ended_at": "2026-09-19T15:30:00.000Z", "duration_seconds": 1740, "thumbnail_url": "https://...", "download_url": "https://...", "download_url_expires_at": "2026-09-19T21:30:00.000Z", "folder_id": null, "organization_id": null, "processing_progress": null, "transcription": { "status": "completed", "language": "en", "speakers": ["Alice", "Bob"], "segments_count": 184 }, "notes": "## Key topics\n...", "notes_status": "completed", "notes_truncated": false, "sharing": { "is_shared": true, "share_url": "https://recordmeeting.com/app/shared/abc123" }, "participants": [ { "id": "participant_id", "displayName": "Alice", "email": "alice@example.com", "source": "calendar", "isOrganizer": true, "mappedSpeaker": "Alice", "avatarUrl": null } ], "media_type": "video", "is_locked": false, "open_url": "https://recordmeeting.com/app/recording/uuid", "media": { "hls_url": "https://...", "direct_url": "https://...", "expires_at": "2026-09-19T21:30:00.000Z" }, "capabilities": { "canDownload": true, "canShare": true, "canViewTranscription": true, "canStartTranscription": true, "canRegenerateTranscription": false, "canRenameSpeaker": true, "canReplaceText": true, "canViewSummary": true, "canGenerateSummary": true, "canAskQuestions": true, "canGenerateArtifacts": true } }}주요 필드
섹션 제목: “주요 필드”| 필드 | 설명 |
|---|---|
notes | Markdown 형식의 회의 노트입니다. 노트가 없거나 녹화가 잠겨 있으면 null입니다. |
download_url | 임시 다운로드 링크입니다. capabilities.canDownload가 true가 아니면 null입니다. download_url_expires_at에 만료됩니다. |
media | 임시 재생 링크입니다. expires_at이 지나면 녹화를 다시 요청하세요. |
media_type | video 또는 audio |
is_locked | 녹화가 잠겨 있으면 true입니다. 이때 transcription과 notes는 null입니다. |
open_url | 웹 앱의 해당 녹화 페이지입니다. |
sharing.share_url | 녹화의 공유 링크이며, 없으면 null입니다. |
오류: 404 RECORDING_NOT_FOUND, 조직의 Enterprise 구독이 더 이상 활성 상태가 아닌 경우 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
스크립트 조회
섹션 제목: “스크립트 조회”GET /v1/recordings/:id/transcript녹화의 스크립트를 세그먼트로 반환하며, 청크 단위의 페이지로 제공합니다.
조직 녹화는 녹화 상세 조회와 동일한 액세스 규칙을 따릅니다. 아직 스크립트가 없는 녹화도 200을 반환하며, "status": "not_started"와 빈 segments 배열을 포함합니다.
쿼리 매개변수
섹션 제목: “쿼리 매개변수”| 매개변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
start_chunk | 정수 | 0 | 반환할 첫 번째 청크의 인덱스 |
limit | 정수 | 50 | 청크 수(1~100) |
{ "data": { "status": "completed", "language": "en", "speakers": ["Alice", "Bob"], "duration": 1740.5, "segments": [ { "id": 1, "start": 0.5, "end": 3.2, "text": "Good morning everyone.", "speaker": "Alice", "confidence": 0.97 } ], "pagination": { "total_chunks": 4, "has_more": true } }}start와 end는 초 단위입니다. speaker와 confidence는 null일 수 있습니다. has_more가 true인 동안 더 큰 start_chunk로 다음 페이지를 요청하세요.
오류: 잠긴 녹화의 경우 403 RECORDING_LOCKED, 조직 또는 구성원에 대해 스크립트 생성이 비활성화된 경우 403 TRANSCRIPT_NOT_AVAILABLE, 전체 스크립트에 유료 요금제가 필요한 경우 403 SUBSCRIPTION_REQUIRED, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
녹화 수정
섹션 제목: “녹화 수정”PATCH /v1/recordings/:id녹화 이름을 바꾸거나 회의 노트를 교체하거나 둘 다 수행합니다. 필드를 하나 이상 제공해야 합니다.
요청 본문
섹션 제목: “요청 본문”{ "title": "New title", "notes": "## Notes\nIn Markdown"}| 필드 | 설명 |
|---|---|
title | 1~500자 |
notes | Markdown 형식의 회의 노트이며 최대 100,000자입니다. 기존 노트를 교체합니다. |
빈 본문과 함께 204 No Content를 반환합니다.
오류: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.
녹화 삭제
섹션 제목: “녹화 삭제”DELETE /v1/recordings/:id녹화와 모든 데이터(스크립트, 노트, 공유 링크)를 영구적으로 삭제합니다.
빈 본문과 함께 204 No Content를 반환합니다.
오류: 404 RECORDING_NOT_FOUND.
공유 링크 생성
섹션 제목: “공유 링크 생성”POST /v1/recordings/:id/share-link녹화의 공개 공유 링크를 생성하거나 기존 링크를 교체합니다. 이전 링크는 더 이상 작동하지 않습니다.
조직 녹화의 경우 해당 녹화를 볼 수 있는 구성원이면 누구나 링크를 만들 수 있습니다. 링크는 녹화 소유자를 대신하여 생성되며 조직의 요금제를 사용합니다.
요청 본문
섹션 제목: “요청 본문”{ "permission": "view"}| 값 | 설명 |
|---|---|
view | 링크가 있는 사람은 녹화를 시청할 수 있습니다 |
download | 링크가 있는 사람은 녹화를 다운로드할 수도 있습니다 |
{ "data": { "share_url": "https://recordmeeting.com/app/shared/abc123", "share_token": "abc123", "permission": "view" }}오류: 400 VALIDATION_ERROR, 아직 녹화를 공유할 수 없는 경우 400 RECORDING_NOT_READY, 403 RECORDING_LOCKED, 조직 또는 구성원에 대해 공유가 비활성화된 경우 403 SHARING_DISABLED, 권한에 유료 요금제가 필요한 경우 403 SUBSCRIPTION_REQUIRED, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
녹화 상태
섹션 제목: “녹화 상태”| 상태 | 설명 |
|---|---|
STARTING | 녹화를 설정하는 중입니다 |
CONNECTING | 회의에 연결하는 중입니다 |
WAIT_APPROVAL | 녹화 승인을 기다리는 중입니다 |
RECORDING | 녹화가 진행 중입니다 |
STALE | 녹화가 완료되기 전에 데이터 전송을 중단했습니다 |
UPLOADING | 녹화가 중지되었고 아직 업로드 중입니다 |
PROCESSING | 비디오를 처리 중이며 아직 재생할 수 없습니다 |
MIGRATING | 비디오를 장기 저장소로 이동하는 동안 재생할 수 있습니다 |
COMPLETED | 녹화가 완전히 처리되었습니다 |
ERROR | 녹화에 실패했습니다 |