Создайте ключ API.

Создает новый стандартный ключ API (или другой ключ управления). Конечная точка управления — если вы проходите аутентификацию с помощью токена Bearer, это должен быть ключ управления API, а не обычный ключ sk-bl-; файл cookie сеанса входа в систему также работает. Ключевое поле в ответе — это единственный раз, когда отображается необработанное значение ключа — впоследствии сохраняется только его хэш, и его нельзя получить снова.

POST/api/v1/keys

Авторизация

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

string · header

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

Тело

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

string

Отображаемое имя ключа; Ведущие/конечные пробелы обрезаются, и результат не может быть пустым.

≤200 chars, trimmed non-empty

keyType

string

Тип ключа, по умолчанию стандартный; любое значение, кроме «управления», считается стандартным.

standardmanagement

Example: "standard"

limit

number | null

Лимит расходов в USD, сохраненный как saveLimitUsd. значение null или опущено означает отсутствие ограничений. Если этот параметр установлен, параметр limit_reset также должен быть предоставлен. GET /v1/key возвращает это же значение в качестве лимита.

0–1,000,000

limit_reset

string | null

Период сброса лимита расходов, сохраненный как saveLimitPeriod. Принимает либо псевдонимы, совместимые с OR (ежедневно/еженедельно/ежемесячно), либо внутренние имена (день/неделя/месяц) — обе формы эквивалентны.

dailyweeklymonthlydayweekmonth

Example: "monthly"

expires_at

string | null

Срок действия ключа — строка даты ISO, которая должна быть в будущем. Значение null или опущено означает, что срок его действия никогда не истекает.

Example: "2027-01-01T00:00:00Z"

organizationId

string | null

Привязывает ключ к данной организации вместо личного кабинета. Вызывающий должен пройти проверку авторизации для этой области организации/команды/участника, иначе запрос вернет 400.

teamId

string | null

Далее распространяется ключ на конкретную команду внутри организации. Используется вместе с идентификатором организации.

orgMemberId

string | null

Далее распространяется ключ на конкретного члена внутри организации. Используется вместе с идентификатором организации.

POST /api/v1/keys

1
2
3
4
curl https://bazaarlink.ai/api/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production", "limit": 50, "limit_reset": "monthly"}'

Примеры ответов

Созданный. Ключевое поле — это полное необработанное значение, отображаемое только в этом ответе — сохраните его немедленно, так как оно никогда не сможет быть снова получено даже вызывающим абонентом.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "id": "key_abc123",
  "name": "production",
  "key": "sk-bl-AbCdEfGh...",
  "keyType": "standard",
  "prefix": "sk-bl-",
  "enabled": true,
  "spendLimitUsd": 50,
  "spendLimitPeriod": "month",
  "expiresAt": null,
  "createdAt": "2026-07-27T00:00:00.000Z",
  "organizationId": null,
  "teamId": null,
  "orgMemberId": null
}