콘텐츠로 이동

인증

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

Create key 버튼이 있는 Settings의 API 키 탭

https://api.recordmeeting.com/v1

이 참조 문서의 엔드포인트 경로는 /v1 접두사를 포함하여 작성됩니다(예: GET /v1/recordings). https://api.recordmeeting.com 뒤에 추가하세요.

Authorization 헤더에 API 키를 전송하세요. 키는 sk_rm_로 시작합니다.

Authorization: Bearer sk_rm_your_key

키를 만들려면 사용 가이드 ➤ API 키를 참조하세요. 키는 계정과 동일한 액세스 권한을 가집니다. 자신의 녹음과 볼 수 있는 권한이 있는 조직의 녹음이 포함됩니다.

Terminal window
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_KEY401키가 존재하지 않거나 해지되었습니다
API_KEY_EXPIRED401키가 만료되었습니다
USER_NOT_FOUND401키가 속한 계정이 더 이상 존재하지 않습니다
AUTH_ERROR401인증에 실패했습니다
코드HTTP 상태의미
VALIDATION_ERROR400잘못되었거나 누락된 요청 매개변수
RECORDING_NOT_READY400녹음을 아직 공유할 수 없습니다
ORGANIZATION_SUBSCRIPTION_EXPIRED402녹음을 소유한 조직에 더 이상 활성 Enterprise 구독이 없습니다
FORBIDDEN403조직의 구성원이 아니거나 요청한 항목을 볼 수 없습니다
RECORDING_LOCKED403녹음이 잠겨 있습니다. 열려면 업그레이드하세요
SUBSCRIPTION_REQUIRED403이 작업에는 유료 플랜이 필요합니다
TRANSCRIPT_NOT_AVAILABLE403조직 또는 구성원에 대해 전사가 비활성화되어 있습니다
SHARING_DISABLED403조직 또는 구성원에 대해 공유가 비활성화되어 있습니다
RECORDING_NOT_FOUND404녹음이 존재하지 않거나 액세스할 수 없습니다
INTERNAL_ERROR500서버 측 오류
  • 녹음: 녹음 나열, 읽기, 업데이트 및 삭제, 트랜스크립트 읽기, 공유 링크 생성
  • 조직: 조직, 폴더 및 구성원
  • API 키 엔드포인트: 키 생성, 나열 및 해지