Management Key

Lấy hoạt động API key

Trả về thống kê hoạt động của một API key trong kỳ được chọn. period nhận day, week, month hoặc year; mọi ranh giới theo UTC: ngày lúc 00:00 UTC, tuần vào 00:00 UTC thứ Hai, tháng vào 00:00 UTC ngày đầu tháng và năm vào 00:00 UTC ngày 1 tháng 1. Với Management Key của tổ chức, chỉ được truy vấn key trong tổ chức đó. Số liệu là chi phí, số request, token, phân tích theo model và chuỗi thời gian của chính key, không phải tổng tổ chức; key ngoài phạm vi trả về 404. Dùng format=csv để xuất CSV.

GET/v1/keys/:id/activity

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Tham số đường dẫn

idbắt buộc

string

ID của API key cần lấy hoạt động.

Tham số truy vấn

period

string

Kỳ thống kê. day, week, month và year đều dùng ranh giới UTC; mặc định là month.

dayweekmonthyear

format

string

Tùy chọn. Đặt là csv để nhận bản xuất CSV; bỏ qua thì trả về 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"

Ví dụ phản hồi

Thành công. totals chứa chi phí, số request và số token của key trong kỳ.

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
    }
  ]
}