Liệt kê API key

Liệt kê các API key tiêu chuẩn thuộc sở hữu của người dùng hiện tại (hoặc một tổ chức được chỉ định). Đây là endpoint quản lý: nếu xác thực bằng Bearer token, nó phải là Management API Key — một key sk-bl- thông thường không thể gọi endpoint này. Session cookie đã đăng nhập cũng hoạt động (dùng cho dashboard web). Phản hồi không bao giờ chứa giá trị key thô, chỉ có prefix/suffix.

GET/api/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

Liệt kê key cho toàn bộ tổ chức thay vì chỉ key của người gọi. Người gọi phải là org_admin hoặc billing_viewer trong tổ chức đó, nếu không request sẽ trả về 403.

GET /api/v1/keys

1
2
curl https://bazaarlink.ai/api/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, mỗi mục gồm thống kê sử dụng, giới hạn chi tiêu, phạm vi tổ chức và gói đăng ký (nếu có) — không bao giờ có giá trị key thô. limitRemainingUsd được tính sẵn theo kỳ reset riêng của key (null nếu không giới hạn); usageDailyUsd/usageWeeklyUsd/usageMonthlyUsd là số liệu theo lịch cố định, không phụ thuộc spendLimitPeriod.

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
{
  "keys": [
    {
      "id": "key_abc123",
      "name": "production",
      "keyPrefix": "sk-bl-",
      "keySuffix": "hDS5",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 1204,
      "totalTokens": 892340,
      "lastUsed": "2026-07-27T03:12:00.000Z",
      "createdAt": "2026-05-01T00:00:00.000Z",
      "spendLimitUsd": 50,
      "spendLimitPeriod": "month",
      "allowedModels": null,
      "expiresAt": null,
      "subscriptionPlanId": null,
      "subscriptionStatus": null,
      "subscriptionStartedAt": null,
      "organizationId": null,
      "teamId": null,
      "orgMemberId": null,
      "subscriptionPlan": null,
      "periodSpendUsd": 4.82,
      "limitRemainingUsd": 45.18,
      "usageDailyUsd": 0.4,
      "usageWeeklyUsd": 2.1,
      "usageMonthlyUsd": 4.82
    }
  ]
}