Management Key

ดูการใช้งาน API key

คืนสถิติการใช้งานของ API key หนึ่งรายการในช่วงเวลาที่เลือก period รับค่า day, week, month หรือ year และทุกขอบเขตยึด UTC ได้แก่ วันเริ่ม 00:00 UTC สัปดาห์เริ่มวันจันทร์ 00:00 UTC เดือนเริ่มวันที่ 1 เวลา 00:00 UTC และปีเริ่มวันที่ 1 มกราคมเวลา 00:00 UTC เมื่อใช้ Management Key ขององค์กร ผู้เรียกจะค้นได้เฉพาะ key ในองค์กรนั้น ตัวเลขที่คืนคือยอดใช้จ่าย จำนวนคำขอ จำนวนโทเคน การแยกตามโมเดล และ time series ของ key นั้นเอง ไม่ใช่ยอดรวมองค์กร หาก key อยู่นอกขอบเขตจะคืนค่า 404 ใช้ format=csv เพื่อส่งออก CSV

GET/v1/keys/:id/activity

การอนุญาต

Authorizationจำเป็น

string · header

API key เป็น bearer token ใน header Authorization

พารามิเตอร์เส้นทาง

idจำเป็น

string

ID ของ API key ที่ต้องการดูการใช้งาน

พารามิเตอร์คิวรี

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 มีข้อมูลยอดใช้จ่าย จำนวนคำขอ และจำนวนโทเคนของ key นี้ในช่วงเวลา

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