Management Key

API 키 생성

새 표준 API 키(또는 또 다른 관리 키)를 생성합니다. 관리 엔드포인트입니다 — Bearer 토큰으로 인증하는 경우 Management API Key여야 하며 일반 sk-bl- 키로는 호출할 수 없습니다. 로그인된 세션 쿠키도 사용할 수 있습니다. 응답의 key 필드는 원본 키 값을 확인할 수 있는 유일한 기회이며, 이후에는 해시만 저장되어 다시 가져올 수 없습니다.

POST/api/v1/keys

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

Body

name필수

string

키의 표시 이름. 앞뒤 공백은 제거되며 결과가 빈 문자열이면 안 됩니다.

≤200 chars, trimmed non-empty

keyType

string

키 종류, 기본값은 standard입니다. "management" 이외의 값은 모두 standard로 처리됩니다.

standardmanagement

Example: "standard"

limit

number | null

지출 한도(USD), spendLimitUsd로 저장됩니다. null이거나 생략하면 한도가 없습니다. 설정할 때는 limit_reset도 함께 제공해야 합니다. GET /v1/key는 이 값을 limit 필드로 그대로 반환합니다.

0–1,000,000

limit_reset

string | null

지출 한도의 재설정 주기, spendLimitPeriod로 저장됩니다. OR 호환 별칭(daily/weekly/monthly) 또는 내부 이름(day/week/month) 중 어느 쪽이든 사용 가능하며 효과는 동일합니다.

dailyweeklymonthlydayweekmonth

Example: "monthly"

expires_at

string | null

키의 만료 시각, 미래여야 하는 ISO 날짜 문자열입니다. null이거나 생략하면 만료되지 않습니다.

Example: "2027-01-01T00:00:00Z"

organizationId

string | null

키를 개인 계정이 아닌 지정된 조직에 바인딩합니다. 호출자는 해당 조직/팀/멤버 범위에 대한 권한 검사를 통과해야 하며, 그렇지 않으면 요청이 400을 반환합니다.

teamId

string | null

조직 내 특정 팀으로 키의 범위를 더 좁힙니다. organizationId와 함께 사용됩니다.

orgMemberId

string | null

조직 내 특정 멤버로 키의 범위를 더 좁힙니다. organizationId와 함께 사용됩니다.

POST /api/v1/keys

1
2
3
4
curl https://bazaarlink.ai/api/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production", "limit": 50, "limit_reset": "monthly"}'

응답 예시

생성됨. key 필드는 전체 원본 값이며 이 응답 한 번에만 표시됩니다 — 즉시 저장하세요. 이후에는 호출자 본인조차 다시 가져올 수 없습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "id": "key_abc123",
  "name": "production",
  "key": "sk-bl-AbCdEfGh...",
  "keyType": "standard",
  "prefix": "sk-bl-",
  "enabled": true,
  "spendLimitUsd": 50,
  "spendLimitPeriod": "month",
  "expiresAt": null,
  "createdAt": "2026-07-27T00:00:00.000Z",
  "organizationId": null,
  "teamId": null,
  "orgMemberId": null
}