Skip to main content
POST
设置用量配置

概览

为贵组织中的每位用户设置或移除附加积分的使用上限。使用上限始终按用户逐一生效。当你指定团队或群组作为作用范围时,上限会分别应用到该团队或群组中的每个用户,而不会为整个团队或群组设置一个共享总上限。

请求

string
必填
具有“Billing Write”(账单写入)权限的服务密钥

额度上限配置(择一)

boolean
设为 true 以清除现有的附加额度上限
integer
设置新的附加额度上限(整数)
必须提供 clear_add_on_credit_capset_add_on_credit_cap 其中之一,且不可同时提供。

作用域配置(任选其一)

boolean
设为 true,将每用户额度上限应用到团队中的每位用户
string
通过提供组 ID,将每用户额度上限应用到指定组中的每位用户
string
通过提供其电子邮箱地址,将配置应用到指定用户
必须提供 team_levelgroup_iduser_email 之一以定义作用域。

示例请求 - 为团队中所有用户设置个人积分上限

示例请求:为用户组内所有用户设置个人额度上限

示例请求 - 设置用户信用额度上限

示例请求 - 清除额度上限

响应

响应体为空。200 状态码表示操作成功。

错误响应

常见错误场景:
  • 服务密钥无效或权限不足
  • 同时提供了 clear_add_on_credit_capset_add_on_credit_cap
  • 未提供 clear_add_on_credit_capset_add_on_credit_cap
  • 提供了多个 scope 参数
  • 未提供 scope 参数
  • 群组 ID 或用户邮箱无效
  • 超出速率限制