인증

모든 API 요청은 API 키를 사용하여 인증되어야 합니다.

기본 URL

https://api.recordmeeting.com/v1

API 키 인증

Authorization 헤더에 API 키를 포함합니다.

Authorization: Bearer <your_api_key>

API 키를 생성하려면 사용자 가이드 → API 키를 참조하세요.

요청 예시

curl -X GET "https://api.recordmeeting.com/v1/recordings"
  -H "Authorization: Bearer rm_your_api_key_here"

오류 응답

모든 오류는 다음 형식을 따릅니다.

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable description"
  }
}

인증 오류 코드

코드	HTTP 상태	의미
UNAUTHORIZED	401	Authorization 헤더가 없거나 형식이 잘못되었습니다.
INVALID_API_KEY	401	키가 존재하지 않거나 폐기되었습니다.
API_KEY_EXPIRED	401	키가 만료되었습니다.
USER_NOT_FOUND	401	키와 연결된 사용자가 더 이상 존재하지 않습니다.
FORBIDDEN	403	인증되었지만 이 리소스에 대한 권한이 없습니다.

일반 오류 코드

코드	HTTP 상태	의미
RECORDING_NOT_FOUND	404	녹화 ID가 존재하지 않거나 접근할 수 없습니다.
RECORDING_LOCKED	403	기능에 구독 업그레이드가 필요합니다.
ORGANIZATION_SUBSCRIPTION_EXPIRED	402	녹화를 소유한 조직에 더 이상 활성 엔터프라이즈 구독이 없습니다.
TRANSCRIPT_NOT_AVAILABLE	403	조직 또는 회원에 대해 전사 기능이 비활성화되었습니다.
SHARING_DISABLED	403	조직 또는 회원에 대해 공유가 비활성화되었습니다.
VALIDATION_ERROR	400	요청 매개변수가 유효하지 않거나 누락되었습니다.
INTERNAL_ERROR	500	서버 측 오류