Buat API key

Membuat API key standar baru (atau management key lain). Endpoint manajemen — jika autentikasi dengan Bearer token, itu harus Management API Key, bukan key sk-bl- biasa; session cookie yang sudah login juga berfungsi. Field key pada respons adalah satu-satunya kesempatan nilai key mentah ditampilkan — setelahnya sistem hanya menyimpan hash dan tidak bisa diambil lagi.

POST/api/v1/keys

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Body

namewajib

string

Nama tampilan untuk key; spasi di awal/akhir dipangkas dan hasilnya tidak boleh kosong.

≤200 chars, trimmed non-empty

keyType

string

Jenis key, default standard; nilai apa pun selain "management" diperlakukan sebagai standard.

standardmanagement

Example: "standard"

limit

number | null

Batas pengeluaran (USD), disimpan sebagai spendLimitUsd. null atau dihilangkan berarti tanpa batas. Saat diset, limit_reset juga harus disertakan. GET /v1/key melaporkan nilai yang sama sebagai limit.

0–1,000,000

limit_reset

string | null

Periode reset batas pengeluaran, disimpan sebagai spendLimitPeriod. Menerima alias kompatibel OR (daily/weekly/monthly) atau nama internal (day/week/month) — keduanya setara.

dailyweeklymonthlydayweekmonth

Example: "monthly"

expires_at

string | null

Waktu kedaluwarsa key, string tanggal ISO yang harus di masa depan. null atau dihilangkan berarti tidak pernah kedaluwarsa.

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

organizationId

string | null

Mengikat key ke organisasi yang diberikan alih-alih akun pribadi. Pemanggil harus lolos pemeriksaan otorisasi untuk cakupan organisasi/tim/anggota tersebut, jika tidak permintaan mengembalikan 400.

teamId

string | null

Mempersempit lebih lanjut key ke tim tertentu dalam organisasi. Digunakan bersama organizationId.

orgMemberId

string | null

Mempersempit lebih lanjut key ke anggota tertentu dalam organisasi. Digunakan bersama 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"}'

Contoh respons

Dibuat. Field key adalah nilai mentah lengkap, hanya ditampilkan sekali dalam respons ini — simpan segera, karena tidak bisa diambil lagi bahkan oleh pemanggil.

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
}