콘텐츠로 이동

API 키 엔드포인트

자신의 API 키를 관리하기 위한 엔드포인트입니다. 모든 경로는 https://api.recordmeeting.com에 있으며 API 키가 필요합니다. Authentication을 참고하세요.

첫 번째 키는 앱의 Settings ➤ API keys에서 만들어야 합니다. User Guide ➤ API Keys를 참고하세요.

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.


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입니다.


DELETE /v1/api-keys/:id

API 키를 영구적으로 폐기합니다. 이후 해당 키를 사용하는 요청은 401 INVALID_API_KEY로 실패합니다. 이 작업은 되돌릴 수 없습니다.

204 No Content이며 본문은 비어 있습니다.

코드HTTP 상태의미
API_KEY_NOT_FOUND404키가 존재하지 않거나 다른 계정에 속해 있습니다
ALREADY_REVOKED400키가 이미 폐기되었습니다