查询计费设置¶

读取账户的余额提醒、消费上限和自动充值设置。

GET https://billing.moi.matrixorigin.cn/api/v1/billing/accounts/$ACCOUNT_ID/settings

调用前准备¶

准备计费账户所属用户的有效个人访问令牌。
调用查询当前账户接口，获取目标账户的 ID。

请求示例¶

将示例中的 $MOI_PERSONAL_ACCESS_TOKEN 和 $ACCOUNT_ID 分别替换为个人访问令牌和所选账户的 ID。

curl -X GET \
  "https://billing.moi.matrixorigin.cn/api/v1/billing/accounts/$ACCOUNT_ID/settings" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN"

路径参数¶

参数	类型	是否必填	说明
`accountID`	string	是	目标账户的 ID，取自“查询当前账户”响应中的 `items[].billing_account_id`。

成功响应¶

请求成功时返回 HTTP 200 和账户当前的计费设置。

响应示例

{
  "billing_account_id": "billing_account_example",
  "balance_alert_enabled": false,
  "warning_threshold_credit": "10",
  "critical_threshold_credit": "5",
  "monthly_spend_limit_credit": "100",
  "pause_when_balance_zero": false,
  "new_account_rate_limit_enabled": false,
  "auto_recharge_enabled": false,
  "auto_recharge_mode": "notify_only",
  "auto_recharge_threshold_credit": "10",
  "auto_recharge_amount": "100.00",
  "auto_recharge_channel": "alipay",
  "auto_recharge_cooldown_hours": 24,
  "auto_recharge_monthly_limit_amount": "500.00",
  "notification_channels": [
    "email"
  ],
  "settings_version": 1,
  "updated_at": 1788739200
}

字段说明

字段	类型	说明
`billing_account_id`	string	Billing 账户 ID。
`balance_alert_enabled`	boolean	是否启用余额提醒。
`warning_threshold_credit`	string	余额预警阈值，单位为 Credit。
`critical_threshold_credit`	string	余额严重告警阈值，单位为 Credit。
`monthly_spend_limit_credit`	string	月度消费上限，单位为 Credit。未设置时返回空字符串。
`pause_when_balance_zero`	boolean	余额归零时暂停使用的设置。
`new_account_rate_limit_enabled`	boolean	是否启用新账户速率限制。
`auto_recharge_enabled`	boolean	是否启用自动充值。
`auto_recharge_mode`	string	自动充值模式。
`auto_recharge_threshold_credit`	string	触发自动充值的余额阈值，单位为 Credit。
`auto_recharge_amount`	string	每次自动充值的支付金额，使用账户默认支付币种。
`auto_recharge_channel`	string	自动充值渠道。
`auto_recharge_authorization_id`	string	自动充值所使用的支付授权 ID，存在时返回。
`auto_recharge_cooldown_hours`	integer	两次自动充值之间的冷却时长，单位为小时。
`auto_recharge_monthly_limit_amount`	string	自动充值月度支付上限，使用账户默认支付币种。
`notification_channels`	array of string	通知渠道。
`settings_version`	integer	设置版本号。
`updated_at`	integer	更新时间，Unix 秒。
`updated_by`	string	最后修改设置的用户 ID，存在时返回。

错误响应¶

缺少认证信息时返回 HTTP 401，请提供有效的个人访问令牌。

响应示例

{
  "code": "unauthenticated",
  "message": "missing bearer token",
  "error": "missing bearer token"
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`message`	string	错误说明。
`error`	string	兼容错误说明，与 message 内容相同。

最后更新于 2026 年 9 月 8 日