인증
Record Meeting API에 대한 모든 요청에는 API 키가 필요합니다. 앱의 Settings ➤ API keys에서 키를 만드세요.

기본 URL
섹션 제목: “기본 URL”https://api.recordmeeting.com/v1이 참조 문서의 엔드포인트 경로는 /v1 접두사를 포함하여 작성됩니다(예: GET /v1/recordings). https://api.recordmeeting.com 뒤에 추가하세요.
API 키 인증
섹션 제목: “API 키 인증”Authorization 헤더에 API 키를 전송하세요. 키는 sk_rm_로 시작합니다.
Authorization: Bearer sk_rm_your_key키를 만들려면 사용 가이드 ➤ API 키를 참조하세요. 키는 계정과 동일한 액세스 권한을 가집니다. 자신의 녹음과 볼 수 있는 권한이 있는 조직의 녹음이 포함됩니다.
요청 예시
섹션 제목: “요청 예시”curl "https://api.recordmeeting.com/v1/recordings" \ -H "Authorization: Bearer sk_rm_your_key"성공적인 응답은 data 아래에 결과가 포함된 JSON입니다. 결과를 페이지로 나누는 목록 엔드포인트는 pagination 객체를 추가합니다. 일부 응답에는 "success": true도 포함됩니다.
PATCH 및 DELETE 요청은 성공 시 빈 본문과 함께 204 No Content로 응답합니다.
오류 응답
섹션 제목: “오류 응답”모든 오류는 다음과 같은 형식을 가집니다.
{ "error": { "code": "ERROR_CODE", "message": "Human readable description" }}인증 오류
섹션 제목: “인증 오류”유효한 Authorization 헤더가 없는 요청은 401을 받습니다.
| 코드 | HTTP 상태 | 의미 |
|---|---|---|
INVALID_API_KEY | 401 | 키가 존재하지 않거나 해지되었습니다 |
API_KEY_EXPIRED | 401 | 키가 만료되었습니다 |
USER_NOT_FOUND | 401 | 키가 속한 계정이 더 이상 존재하지 않습니다 |
AUTH_ERROR | 401 | 인증에 실패했습니다 |
일반적인 오류 코드
섹션 제목: “일반적인 오류 코드”| 코드 | HTTP 상태 | 의미 |
|---|---|---|
VALIDATION_ERROR | 400 | 잘못되었거나 누락된 요청 매개변수 |
RECORDING_NOT_READY | 400 | 녹음을 아직 공유할 수 없습니다 |
ORGANIZATION_SUBSCRIPTION_EXPIRED | 402 | 녹음을 소유한 조직에 더 이상 활성 Enterprise 구독이 없습니다 |
FORBIDDEN | 403 | 조직의 구성원이 아니거나 요청한 항목을 볼 수 없습니다 |
RECORDING_LOCKED | 403 | 녹음이 잠겨 있습니다. 열려면 업그레이드하세요 |
SUBSCRIPTION_REQUIRED | 403 | 이 작업에는 유료 플랜이 필요합니다 |
TRANSCRIPT_NOT_AVAILABLE | 403 | 조직 또는 구성원에 대해 전사가 비활성화되어 있습니다 |
SHARING_DISABLED | 403 | 조직 또는 구성원에 대해 공유가 비활성화되어 있습니다 |
RECORDING_NOT_FOUND | 404 | 녹음이 존재하지 않거나 액세스할 수 없습니다 |
INTERNAL_ERROR | 500 | 서버 측 오류 |
엔드포인트
섹션 제목: “엔드포인트”- 녹음: 녹음 나열, 읽기, 업데이트 및 삭제, 트랜스크립트 읽기, 공유 링크 생성
- 조직: 조직, 폴더 및 구성원
- API 키 엔드포인트: 키 생성, 나열 및 해지