Cập nhật API key

Bật/tắt một key, hoặc thiết lập/xóa giới hạn chi tiêu của nó — mỗi lần gọi chỉ làm đúng một trong hai, không bao giờ cả hai cùng lúc. Endpoint quản lý với cùng quy tắc như tạo key: Bearer token phải là Management API Key, hoặc dùng session đã đăng nhập.

PATCH/api/v1/keys/:id

Xác thực

Authorizationbắt buộc

string · header

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

Tham số đường dẫn

idbắt buộc

string

ID của key cần cập nhật.

Body

enabled

boolean

Bật (true) hoặc tắt (false) key này. Bất kỳ lần chuyển đổi thủ công nào cũng xóa cờ tự động vô hiệu hóa do vượt giới hạn chi tiêu trước đó, để key không bao giờ bị tự động bật lại âm thầm trái với ý định của bạn.

spendLimitUsd

number | null

Đặt giới hạn chi tiêu (USD); truyền null để xóa giới hạn. Loại trừ lẫn nhau với enabled — một request chỉ có thể gửi một trong hai.

positive, ≤1,000,000

spendLimitPeriod

string | null

Chu kỳ đặt lại giới hạn chi tiêu. Bắt buộc bất cứ khi nào spendLimitUsd được đặt, và chỉ chấp nhận giá trị gốc day/week/month — khác với endpoint tạo key, các bí danh daily/weekly/monthly KHÔNG được chấp nhận ở đây.

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

Ví dụ phản hồi

Đã cập nhật. Phản hồi chỉ là một cờ xác nhận, không phải bản ghi key đầy đủ — hãy gọi lại danh sách key để xem trạng thái hiện tại.

1
2
3
{
  "updated": true
}