API 키

API 키 생성

POST /api/v1/api-keys

인증된 사용자를 위한 새 API 키를 생성합니다.

요청 본문

{
  "name": "My integration"
}

필드	필수	설명
name	예	키에 대한 표시 이름 (1-100자)

응답

{
  "data": {
    "id": "key_uuid",
    "name": "My integration",
    "prefix": "rm_abc123",
    "key": "rm_abc123def456...",
    "created_at": "2025-09-19T15:00:00.000Z"
  }
}

주의

key 필드는 생성 시점에 단 한 번만 반환됩니다. 안전하게 저장하십시오. 다시 검색할 수 없습니다. 후속 요청에서는 prefix (첫 8자)만 표시됩니다.

---

API 키 목록

GET /api/v1/api-keys

인증된 사용자의 모든 API 키를 반환합니다. 전체 키 값은 생성 후에는 반환되지 않습니다.

응답

{
  "data": [
    {
      "id": "key_uuid",
      "name": "My integration",
      "prefix": "rm_abc123",
      "created_at": "2025-09-19T15:00:00.000Z",
      "last_used_at": "2025-09-20T10:30:00.000Z",
      "is_revoked": false
    }
  ]
}

---

API 키 해지

DELETE /api/v1/api-keys/:id

API 키를 영구적으로 해지합니다. 이 키를 사용하는 요청은 즉시 INVALID_API_KEY 오류와 함께 실패합니다.

응답

{
  "data": { "success": true }
}

오류 코드

코드	HTTP 상태	의미
API_KEY_NOT_FOUND	404	키가 존재하지 않거나 다른 사용자에게 속합니다
ALREADY_REVOKED	400	키가 이미 해지되었습니다