Ключи управления

Список API-ключей

Возвращает API-ключи, которыми может управлять вызывающая сторона. При использовании организационного Management Key ответ содержит только ключи его организации: личные ключи владельца и ключи других организаций никогда не включаются. Обычный ключ sk-bl- не может вызывать этот административный endpoint; веб-панель также поддерживает cookie авторизованной сессии. Каждый элемент keys[] содержит limit, limit_remaining, limit_reset, usage, usage_daily/weekly/monthly, requests, requests_daily/weekly/monthly и usage_scope: key. Эти значения совпадают с GET /v1/key при вызове с соответствующим ключом. При наличии собственного лимита limit_remaining равен лимиту минус расход за период сброса; без собственного лимита это баланс, используемый ключом. Секрет ключа никогда не возвращается. Рабочий пример с общим итогом организации и использованием каждого ключа находится на странице GET /v1/key.

GET/v1/keys

Авторизация

Authorizationобязательно

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Параметры запроса

orgId

string

При использовании cookie сессии можно указать ID организации, если вызывающий имеет роль 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[] отсортирован от новых к старым и содержит метаданные и использование каждого ключа, но не его секрет.

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