Management Key

API 키 활동 조회

선택한 기간 동안 하나의 API 키 활동 통계를 반환합니다. period는 day, week, month, year 중 하나이며 모든 경계는 UTC 기준입니다. 일은 UTC 00:00, 주는 월요일 UTC 00:00, 월은 매월 1일 UTC 00:00, 연은 1월 1일 UTC 00:00에 시작합니다. 조직 Management Key는 같은 조직의 키만 조회할 수 있습니다. 반환값은 조직 전체가 아닌 해당 키 자체의 사용액, 요청 수, 토큰 수, 모델별 내역, 시계열입니다. 호출자 범위 밖의 키는 404를 반환합니다. CSV 내보내기는 format=csv를 사용하세요.

GET/v1/keys/:id/activity

인증

Authorization필수

string · header

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

경로 파라미터

id필수

string

활동을 조회할 API 키의 ID입니다.

쿼리 파라미터

period

string

통계 기간입니다. day, week, month, year 모두 UTC 경계를 사용하며 기본값은 month입니다.

dayweekmonthyear

format

string

선택 사항입니다. csv로 설정하면 CSV를 반환하고 생략하면 JSON을 반환합니다.

csv

GET /v1/keys/:id/activity

1
2
curl "https://api.bazaarlink.ai/v1/keys/key_demo_01/activity?period=month" \
  -H "Authorization: Bearer $BAZAARLINK_MANAGEMENT_KEY"

응답 예시

성공. totals에는 기간 동안 해당 키의 사용액, 요청 수, 토큰 수가 포함됩니다.

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
{
  "keyName": "worker-a",
  "period": "month",
  "since": "2026-09-01T00:00:00.000Z",
  "totals": {
    "spend": 9.37,
    "requests": 205,
    "tokens": 48200
  },
  "byModel": [
    {
      "model": "example-model",
      "spend": 9.37,
      "tokens": 48200,
      "requests": 205
    }
  ],
  "timeSeries": [
    {
      "date": "2026-09-30",
      "model": "example-model",
      "cost": 2.12,
      "tokens": 10400,
      "requests": 18
    }
  ]
}