อัปเดต API key

เปิด/ปิดใช้งานคีย์ หรือกำหนด/ล้างขีดจำกัดการใช้จ่าย — แต่ละคำขอทำได้เพียงอย่างใดอย่างหนึ่งเท่านั้น ไม่สามารถทำทั้งสองพร้อมกัน เป็น endpoint การจัดการที่มีกฎเดียวกับการสร้างคีย์: Bearer token ต้องเป็น Management API Key หรือใช้ session ที่ล็อกอินแล้ว

PATCH/api/v1/keys/:id

การอนุญาต

Authorizationจำเป็น

string · header

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

พารามิเตอร์เส้นทาง

idจำเป็น

string

ID ของคีย์ที่จะอัปเดต

Body

enabled

boolean

เปิดใช้งาน (true) หรือปิดใช้งาน (false) คีย์นี้ การสลับด้วยตนเองครั้งใดก็ตามจะล้างแฟล็กปิดใช้งานอัตโนมัติจากขีดจำกัดการใช้จ่ายก่อนหน้า เพื่อไม่ให้ระบบเปิดใช้งานคืนโดยอัตโนมัติอย่างเงียบ ๆ ในภายหลังซึ่งขัดกับความตั้งใจของคุณ

spendLimitUsd

number | null

กำหนดขีดจำกัดการใช้จ่าย (USD) ส่ง null เพื่อล้างขีดจำกัด ไม่สามารถใช้ร่วมกับ enabled ได้ — คำขอเดียวส่งได้เพียงอย่างใดอย่างหนึ่ง

positive, ≤1,000,000

spendLimitPeriod

string | null

รอบรีเซ็ตขีดจำกัดการใช้จ่าย จำเป็นทุกครั้งที่กำหนด spendLimitUsd และรับเฉพาะค่าดิบ day/week/month เท่านั้น — ต่างจาก endpoint สร้างคีย์ ชื่อเทียบเท่า daily/weekly/monthly จะไม่ถูกรับที่นี่

dayweekmonth

PATCH /api/v1/keys/:id

1
2
3
4
curl -X PATCH https://bazaarlink.ai/api/v1/keys/key_abc123 \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

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

อัปเดตแล้ว การตอบกลับเป็นเพียงแฟล็กยืนยัน ไม่ใช่ข้อมูลคีย์แบบเต็ม — เรียกดูรายการคีย์อีกครั้งเพื่อดูสถานะปัจจุบัน

1
2
3
{
  "updated": true
}