สร้าง API key

สร้าง API key มาตรฐานใหม่ (หรือ management key อีกตัว) เป็น endpoint การจัดการ — หากยืนยันตัวตนด้วย Bearer token จะต้องเป็น Management API Key ไม่ใช่ key sk-bl- ทั่วไป session cookie ที่ล็อกอินแล้วก็ใช้ได้ ฟิลด์ key ในการตอบกลับเป็นโอกาสเดียวที่จะเห็นค่าคีย์ดิบ — หลังจากนั้นระบบจะเก็บเฉพาะแฮชเท่านั้น ไม่สามารถดึงกลับมาได้อีก

POST/api/v1/keys

การอนุญาต

Authorizationจำเป็น

string · header

API key เป็น bearer token ใน header Authorization

Body

nameจำเป็น

string

ชื่อที่แสดงของคีย์ ช่องว่างหน้า/หลังจะถูกตัดออก และผลลัพธ์ต้องไม่ว่างเปล่า

≤200 chars, trimmed non-empty

keyType

string

ประเภทคีย์ ค่าเริ่มต้นคือ standard ค่าใด ๆ ที่ไม่ใช่ "management" จะถูกถือว่าเป็น standard

standardmanagement

Example: "standard"

limit

number | null

ขีดจำกัดการใช้จ่าย (USD) เก็บเป็น spendLimitUsd null หรือละไว้หมายถึงไม่มีขีดจำกัด เมื่อกำหนดค่าต้องระบุ limit_reset ด้วย GET /v1/key จะรายงานค่าเดียวกันนี้กลับมาในฟิลด์ limit

0–1,000,000

limit_reset

string | null

รอบรีเซ็ตขีดจำกัดการใช้จ่าย เก็บเป็น spendLimitPeriod รับได้ทั้งชื่อเทียบเท่า OR (daily/weekly/monthly) หรือชื่อภายใน (day/week/month) — ทั้งสองแบบให้ผลเหมือนกัน

dailyweeklymonthlydayweekmonth

Example: "monthly"

expires_at

string | null

เวลาหมดอายุของคีย์ เป็นสตริงวันที่ ISO ที่ต้องอยู่ในอนาคต null หรือละไว้หมายถึงไม่มีวันหมดอายุ

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

organizationId

string | null

ผูกคีย์กับองค์กรที่ระบุแทนบัญชีส่วนตัว ผู้เรียกต้องผ่านการตรวจสอบสิทธิ์สำหรับขอบเขตองค์กร/ทีม/สมาชิกนั้น มิฉะนั้นคำขอจะคืนค่า 400

teamId

string | null

จำกัดขอบเขตคีย์เพิ่มเติมไปยังทีมที่ระบุภายในองค์กร ใช้ร่วมกับ organizationId

orgMemberId

string | null

จำกัดขอบเขตคีย์เพิ่มเติมไปยังสมาชิกที่ระบุภายในองค์กร ใช้ร่วมกับ 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"}'

ตัวอย่างการตอบกลับ

สร้างสำเร็จ ฟิลด์ key คือค่าดิบแบบเต็ม จะแสดงเพียงครั้งเดียวในการตอบกลับนี้ — โปรดบันทึกทันที เพราะหลังจากนี้แม้แต่ผู้เรียกเองก็ไม่สามารถดึงกลับมาได้อีก

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
}