Tạo API key

Tạo một API key tiêu chuẩn mới (hoặc một management key khác). Đây là endpoint quản lý — nếu xác thực bằng Bearer token, nó phải là Management API Key, không phải key sk-bl- thông thường; session cookie đã đăng nhập cũng hoạt động. Trường key trong phản hồi là lần duy nhất giá trị key thô được hiển thị — sau đó hệ thống chỉ lưu hash và không thể lấy lại.

POST/api/v1/keys

Xác thực

Authorizationbắt buộc

string · header

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

Body

namebắt buộc

string

Tên hiển thị cho key; khoảng trắng đầu/cuối bị cắt bỏ và kết quả không được rỗng.

≤200 chars, trimmed non-empty

keyType

string

Loại key, mặc định standard; bất kỳ giá trị nào khác "management" đều được coi là standard.

standardmanagement

Example: "standard"

limit

number | null

Giới hạn chi tiêu (USD), lưu dưới dạng spendLimitUsd. null hoặc bỏ qua nghĩa là không giới hạn. Khi thiết lập, phải cung cấp cả limit_reset. GET /v1/key trả về cùng giá trị này ở trường limit.

0–1,000,000

limit_reset

string | null

Chu kỳ đặt lại giới hạn chi tiêu, lưu dưới dạng spendLimitPeriod. Chấp nhận bí danh tương thích OR (daily/weekly/monthly) hoặc tên nội bộ (day/week/month) — cả hai đều tương đương.

dailyweeklymonthlydayweekmonth

Example: "monthly"

expires_at

string | null

Thời điểm hết hạn của key, chuỗi ngày ISO phải là thời điểm trong tương lai. null hoặc bỏ qua nghĩa là không bao giờ hết hạn.

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

organizationId

string | null

Gắn key vào tổ chức đã cho thay vì tài khoản cá nhân. Người gọi phải vượt qua kiểm tra ủy quyền cho phạm vi tổ chức/team/thành viên đó, nếu không request trả về 400.

teamId

string | null

Thu hẹp phạm vi key hơn nữa đến một team cụ thể trong tổ chức. Dùng cùng với organizationId.

orgMemberId

string | null

Thu hẹp phạm vi key hơn nữa đến một thành viên cụ thể trong tổ chức. Dùng cùng với organizationId.

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"}'

Ví dụ phản hồi

Đã tạo. Trường key là giá trị thô đầy đủ, chỉ hiển thị một lần trong phản hồi này — hãy lưu ngay lập tức, vì sau đó không thể lấy lại được nữa, kể cả người gọi.

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
}