Management Key

API 키 목록

현재 사용자(또는 지정된 조직)가 소유한 표준 API 키를 나열합니다. 이는 관리 엔드포인트입니다. Bearer 토큰으로 인증하는 경우 Management API Key여야 하며, 일반 sk-bl- 키로는 이 엔드포인트를 호출할 수 없습니다. 로그인된 세션 쿠키도 사용할 수 있습니다(웹 대시보드용). 응답에는 원본 키 값이 절대 포함되지 않으며 prefix/suffix만 포함됩니다.

GET/api/v1/keys

인증

Authorization필수

string · header

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

쿼리 파라미터

orgId

string

호출자 자신의 키뿐 아니라 조직 전체의 키를 나열합니다. 호출자는 해당 조직의 org_admin 또는 billing_viewer여야 하며, 그렇지 않으면 요청이 403을 반환합니다.

GET /api/v1/keys

1
2
curl https://bazaarlink.ai/api/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

응답 예시

성공. keys[]는 최신순으로 정렬되며, 각 항목에는 사용량 통계, 지출 한도, 조직 범위, 구독 플랜(있는 경우)이 포함됩니다 — 원본 키 값 자체는 절대 포함되지 않습니다. limitRemainingUsd는 이 키 자체의 리셋 기간을 기준으로 미리 계산된 값(무제한이면 null)이며, usageDailyUsd/usageWeeklyUsd/usageMonthlyUsd는 spendLimitPeriod와 무관한 고정 달력 구간의 사용량입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
  "keys": [
    {
      "id": "key_abc123",
      "name": "production",
      "keyPrefix": "sk-bl-",
      "keySuffix": "hDS5",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 1204,
      "totalTokens": 892340,
      "lastUsed": "2026-07-27T03:12:00.000Z",
      "createdAt": "2026-05-01T00:00:00.000Z",
      "spendLimitUsd": 50,
      "spendLimitPeriod": "month",
      "allowedModels": null,
      "expiresAt": null,
      "subscriptionPlanId": null,
      "subscriptionStatus": null,
      "subscriptionStartedAt": null,
      "organizationId": null,
      "teamId": null,
      "orgMemberId": null,
      "subscriptionPlan": null,
      "periodSpendUsd": 4.82,
      "limitRemainingUsd": 45.18,
      "usageDailyUsd": 0.4,
      "usageWeeklyUsd": 2.1,
      "usageMonthlyUsd": 4.82
    }
  ]
}