API 키 엔드포인트
자신의 API 키를 관리하기 위한 엔드포인트입니다. 모든 경로는 https://api.recordmeeting.com에 있으며 API 키가 필요합니다. Authentication을 참고하세요.
첫 번째 키는 앱의 Settings ➤ API keys에서 만들어야 합니다. User Guide ➤ API Keys를 참고하세요.
API 키 생성
섹션 제목: “API 키 생성”POST /v1/api-keys계정에 새 API 키를 생성합니다.
요청 본문
섹션 제목: “요청 본문”{ "name": "My integration"}| 필드 | 필수 | 설명 |
|---|---|---|
name | 예 | 키의 표시 이름 (1~100자) |
201 Created
{ "data": { "id": "key_uuid", "name": "My integration", "prefix": "sk_rm_a1b2c3", "key": "sk_rm_a1b2c3d4e5f6...", "created_at": "2026-09-19T15:00:00.000Z" }}오류: 400 VALIDATION_ERROR.
API 키 목록 조회
섹션 제목: “API 키 목록 조회”GET /v1/api-keys계정의 API 키를 반환합니다. 전체 키 값은 생성 이후에는 반환되지 않습니다.
{ "data": [ { "id": "key_uuid", "name": "My integration", "prefix": "sk_rm_a1b2c3", "created_at": "2026-09-19T15:00:00.000Z", "last_used_at": "2026-09-20T10:30:00.000Z", "is_revoked": false } ]}한 번도 사용되지 않은 키의 last_used_at은 null입니다.
API 키 폐기
섹션 제목: “API 키 폐기”DELETE /v1/api-keys/:idAPI 키를 영구적으로 폐기합니다. 이후 해당 키를 사용하는 요청은 401 INVALID_API_KEY로 실패합니다. 이 작업은 되돌릴 수 없습니다.
204 No Content이며 본문은 비어 있습니다.
오류 코드
섹션 제목: “오류 코드”| 코드 | HTTP 상태 | 의미 |
|---|---|---|
API_KEY_NOT_FOUND | 404 | 키가 존재하지 않거나 다른 계정에 속해 있습니다 |
ALREADY_REVOKED | 400 | 키가 이미 폐기되었습니다 |