Management Key

Liệt kê API key

Liệt kê các API key mà người gọi được phép quản lý. Khi dùng Management Key của tổ chức, phản hồi chỉ chứa các key thuộc tổ chức của key đó; không bao giờ chứa key cá nhân của chủ sở hữu hoặc key của tổ chức khác. Key sk-bl- thông thường không thể gọi endpoint quản lý này; dashboard web cũng hỗ trợ session cookie đã đăng nhập. Mỗi phần tử keys[] gồm limit, limit_remaining, limit_reset, usage, usage_daily/weekly/monthly, requests, requests_daily/weekly/monthly và usage_scope: key. Các giá trị này khớp với GET /v1/key khi gọi bằng chính key đó. Nếu có hạn mức riêng, limit_remaining bằng hạn mức trừ chi phí trong kỳ đặt lại; nếu không có hạn mức riêng, đó là số dư mà key sử dụng. Không bao giờ trả về bí mật thô của key. Xem ví dụ Management Key trên trang GET /v1/key để xem tổng tổ chức rồi mức sử dụng của từng key.

GET/v1/keys

Xác thực

Authorizationbắt buộc

string · header

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

Tham số truy vấn

orgId

string

Với session cookie, có thể chỉ định ID tổ chức để liệt kê key nếu người gọi là org_admin hoặc billing_viewer của tổ chức đó. Management Key của tổ chức chỉ bị giới hạn ở tổ chức của chính nó và không thể chuyển tổ chức bằng tham số này.

GET /v1/keys

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

Ví dụ phản hồi

Thành công. keys[] được sắp xếp mới nhất trước và chứa metadata cùng mức sử dụng của từng key, không bao giờ chứa secret thô.

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