更新低余额提醒
PUT
/v1/billing/alert更新当前认证账户的低余额提醒设置。
认证
Authorization Bearer
在 Authorization 请求头中携带 API Key(sk-...)。
请求体
request_schema
1{
2 "fields": [
3 { "key": "enabled", "type": "boolean", "required": true, "label": "是否启用低余额邮件提醒。" },
4 { "key": "threshold", "type": "number", "required": false, "label": "低余额阈值(USD)。如提供,必须大于 0。" }
5 ]
6}响应
codeinteger响应状态码。
dataobject更新后的低余额提醒设置。
data.coupon_availablenumberCoupon / Credit 可用余额。
data.total_spendablenumber当前可支付余额。
data.enabledboolean是否启用低余额邮件提醒。
data.last_notified_atstring | null最近一次提醒时间。
data.last_recovered_atstring | null余额恢复到阈值以上的最近时间。
data.thresholdnumber提醒阈值(USD)。
data.wallet_availablenumber钱包可用余额。
错误处理
- 401 / 未认证:缺少或无效的
Authorization。 - 参数校验错误:
enabled必填;如提供threshold,必须大于0。 - 企业子账号不能直接使用钱包提醒接口。
此页面对您有帮助吗?