Management Key

แสดงรายการ API key

แสดงรายการ API key ที่ผู้เรียกมีสิทธิ์จัดการ เมื่อใช้ Management Key ขององค์กร การตอบกลับจะมีเฉพาะ key ที่อยู่ในองค์กรของ key นั้นเท่านั้น ไม่รวม key ส่วนตัวของเจ้าของหรือ key จากองค์กรอื่นเลย key sk-bl- ทั่วไปเรียก endpoint จัดการนี้ไม่ได้ และแดชบอร์ดเว็บรองรับ session cookie ที่เข้าสู่ระบบแล้วด้วย แต่ละรายการใน keys[] มี limit, limit_remaining, limit_reset, usage, usage_daily/weekly/monthly, requests, requests_daily/weekly/monthly และ usage_scope: key ค่าเหล่านี้ตรงกับ GET /v1/key เมื่อเรียกด้วย key นั้น หากมีขีดจำกัดเฉพาะ key ค่า limit_remaining คือขีดจำกัดลบด้วยยอดใช้จ่ายในช่วงรีเซ็ต หากไม่มีขีดจำกัดเฉพาะ key จะเป็นยอดคงเหลือที่ key นั้นใช้ จะไม่คืนค่า secret ของ key แบบเต็ม ดูตัวอย่าง Management Key ในหน้า GET /v1/key เพื่อดูยอดรวมองค์กรแล้วดูการใช้งานของแต่ละ key

GET/v1/keys

การอนุญาต

Authorizationจำเป็น

string · header

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

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

orgId

string

เมื่อใช้ session cookie สามารถระบุ organization ID เพื่อแสดง key ขององค์กรนั้นได้ หากผู้เรียกเป็น org_admin หรือ billing_viewer ขององค์กรนั้น ส่วน Management Key ขององค์กรจะจำกัดอยู่ที่องค์กรของตนเองและเปลี่ยนองค์กรด้วยพารามิเตอร์นี้ไม่ได้

GET /v1/keys

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

ตัวอย่างการตอบกลับ

สำเร็จ keys[] เรียงจากใหม่ไปเก่าและมี metadata กับการใช้งานของแต่ละ key แต่ไม่คืนค่า secret เต็ม

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