Skip to main content
POST
API 키 발급

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

organization_id
string
required

API 키를 발급할 조직 ID입니다. 본인 조직 또는 직속 하위 조직을 지정합니다.

Body

application/json

API 키 발급 옵션입니다. key_name은 필수입니다.

하위 조직 API 키 발급 요청입니다. key_name은 필수입니다. 내부 키 ID를 응답에 노출하지 않으므로 폐기할 키는 key_namesecret_key_suffix 쌍으로 식별합니다.

key_name
string
required

키를 식별할 이름입니다. 앞뒤 공백은 제거합니다. 공백만 입력하면 400을 반환합니다. secret_key_suffix와 함께 폐기할 키를 식별하므로 필수입니다.

Required string length: 1 - 255

Response

성공 응답

API 키 발급 응답입니다. 평문 키는 이 응답에서 한 번만 제공하며 다시 조회할 수 없습니다.

secret_key_suffix
string
required

평문 키의 끝 4자리입니다. key_name과 함께 폐기할 키를 식별합니다.

created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

api_key
string
required

평문 API 키입니다. 다시 조회할 수 없으므로 즉시 안전한 곳에 저장하세요.

key_name
string | null

secret_key_suffix와 함께 폐기할 키를 식별하는 이름입니다.

last_used_at
integer | null

이 키로 마지막으로 인증에 성공한 시각입니다. unix milliseconds 형식입니다. 한 번도 사용하지 않았다면 null입니다. 비동기로 기록하므로 최대 1분가량 지연될 수 있습니다.