管理密钥

更新 API 密钥

启用/停用一把密钥,或设置/清除它的支出上限——每次调用只能做其中一件事,不能两个一起改。管理端点,规则同创建密钥:Bearer token 必须是 Management API Key,或用登录 session。

PATCH/api/v1/keys/:id

验证

Authorization必填

string · header

在 Authorization 标头以 Bearer token 传入 API 密钥。

路径参数

id必填

string

要更新的密钥 ID。

Body

enabled

boolean

启用(true)或停用(false)这把密钥。任何一次手动切换都会清除之前因超支自动停用留下的标记,避免之后被系统误判成自动恢复。

spendLimitUsd

number | null

设置支出上限(美元);传 null 表示清除上限。跟 enabled 是互斥操作,同一次请求只能传其中一种。

positive, ≤1,000,000

spendLimitPeriod

string | null

支出上限的重置周期。spendLimitUsd 有值时必填,且只接受 day/week/month 这三个原始值——不像创建密钥那支还接受 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
}