Management Key

API 키 목록 조회

호출자가 관리할 수 있는 API 키를 나열합니다. 조직 Management Key를 사용하면 해당 키가 속한 조직의 키만 반환하며 소유자의 개인 키나 다른 조직의 키는 절대 포함하지 않습니다. 일반 sk-bl- 키는 이 관리 엔드포인트를 호출할 수 없고, 웹 대시보드는 로그인 세션 쿠키도 지원합니다. 각 keys[] 항목에는 limit, limit_remaining, limit_reset, usage, usage_daily/weekly/monthly, requests, requests_daily/weekly/monthly, usage_scope: key가 포함됩니다. 이 값은 해당 키로 GET /v1/key를 호출했을 때와 같습니다. 개별 한도가 있으면 limit_remaining은 재설정 주기 사용액을 뺀 값이고, 없으면 해당 키가 사용하는 잔액입니다. 원본 키 비밀값은 반환하지 않습니다. 조직 총액과 각 키의 사용량을 차례로 보는 예시는 GET /v1/key 페이지의 Management Key 예시를 참고하세요.

GET/v1/keys

인증

Authorization필수

string · header

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

쿼리 파라미터

orgId

string

세션 쿠키를 사용하면 호출자가 해당 조직의 org_admin 또는 billing_viewer일 때 조직 ID를 지정하여 키를 나열할 수 있습니다. 조직 Management Key는 자신의 조직으로 제한되며 이 매개변수로 조직을 바꿀 수 없습니다.

GET /v1/keys

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

응답 예시

성공. keys[]는 최신순이며 각 키의 메타데이터와 사용량을 포함하고 원본 비밀값은 포함하지 않습니다.

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
33
34
35
{
  "keys": [
    {
      "id": "key_demo_01",
      "name": "worker-a",
      "keyPrefix": "demo_",
      "keySuffix": "01",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 73,
      "totalTokens": 48200,
      "lastUsed": "2026-09-30T02:14:00.000Z",
      "createdAt": "2026-09-01T00:00:00.000Z",
      "spendLimitUsd": 10,
      "spendLimitPeriod": "day",
      "limit": 10,
      "limit_remaining": 7.88,
      "limit_reset": "day",
      "usage": 24.41,
      "usage_daily": 2.12,
      "usage_weekly": 5.64,
      "usage_monthly": 9.37,
      "requests": 314,
      "requests_daily": 18,
      "requests_weekly": 61,
      "requests_monthly": 205,
      "usage_scope": "key",
      "allowedModels": null,
      "expiresAt": null,
      "organizationId": "org_demo_01",
      "teamId": null,
      "orgMemberId": null
    }
  ]
}