Skip to main content
PUT
PUT /billing/autorecharge/regular 端点开启或关闭 Bright Data 账户的常规自动充值,并设置扣款的支付方式和充值金额。数据集自动充值设置不会改变。
将您的 API key 粘贴到授权字段中。要获取 API key,请创建账号,并查看如何生成新的 API key?

此端点需要哪种 API key 权限?

PUT /billing/autorecharge/regular 需要 billing.write.pay.settings 权限。具有管理员或财务权限级别的 API key 拥有该权限。缺少该权限时,端点返回 HTTP 403 和纯文本消息。请在账户设置中管理 API key 权限。

如何开启常规自动充值?

发送 enabled: true,并附带 pmethod_id 和 amount:
  1. 从 GET /billing/pmethods 获取 autorecharge_supported 为 true 的支付方式 ID。
  2. 从 GET /billing/autorecharge 的 regular.limits 获取允许的金额范围。
  3. 发送请求:
响应返回新的常规自动充值设置,包括 threshold。

常规自动充值扣款多少?

当可用余额低于 ceil(amount / 4) 时开始充值。常规自动充值从不将余额补足到某个目标水平。扣款金额取决于当时的余额:
  • 余额大于零:扣款金额正好为 amount
  • 余额为零或负数:扣款金额为 amount × ceil(欠款 / amount),最多为 10 × amount
例如,当 amount 设置为 200 时,可用余额低于 $50 时开始充值:

充值金额有哪些规则?

amount 以美元计,必须满足:
  • 为整数美元。否则端点返回 amount_not_whole
  • 不低于 limits.min_amount,所有账户均为 $50。否则端点返回 amount_too_low
  • 不高于 limits.max_amount,该值取决于公司类型,也可以按账户调整。否则端点返回 amount_too_high
可从 GET /billing/autorecharge 读取账户的 limits.min_amount 和 limits.max_amount。

如何关闭常规自动充值?

只发送 enabled: false,不附带其他字段:
关闭自动充值始终允许,即使 available 为 false。关闭常规自动充值不会关闭数据集自动充值。在 enabled: false 时发送 pmethod_id 或 amount 会返回 invalid_param。

PUT 如何更新设置?

请求体包含常规部分的全部设置,请求是幂等的。重复发送相同的请求体,设置保持不变。如只需修改金额,请发送 enabled: true,附带当前的 pmethod_id 和新的 amount。

此端点可能返回哪些错误?

HTTP 400 和 not_eligible 的 HTTP 403 返回包含 error 和 error_code 的 JSON: HTTP 401、权限不足导致的 HTTP 403 和 HTTP 429 返回纯文本。账单端点允许每分钟 1,000 个请求、每小时 5,000 个请求。

相关端点

授权

Authorization
string
header
必填

在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。

认证方法:

  1. 从 Bright Data 账户设置获取您的 API Key: https://brightdata.com/cp/setting/users
  2. 在请求的 Authorization 头中包含 API Key
  3. 格式: Authorization: Bearer YOUR_API_KEY

示例:

了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?

请求体

application/json
enabled
enum<boolean>
必填
可用选项:
true
pmethod_id
string
必填

来自 GET /billing/pmethods 的支付方式 ID。

示例:

"64f0c2a1e4b0a1b2c3d4e5f6"

amount
integer
必填

充值金额,单位为美元,必须为整数,介于 limits.min_amount 和 limits.max_amount 之间。

示例:

200

响应

新的常规自动充值设置

available
boolean
必填

账户可使用常规自动充值,且账户中有支持自动充值的支付方式时为 true。AWS Marketplace organic 账户、IBM 账户,以及没有支持自动充值的支付方式或所有此类支付方式均被冻结的账户为 false。

enabled
boolean
必填

此部分已启用自动充值时为 true。

pmethod_id
string | null
必填

用于自动充值的支付方式。停用时为 null。

amount
integer | null
必填

充值金额,单位为美元。停用时为 null。

threshold
number | null
必填
read-only

触发充值的余额水平:当可用余额低于 ceil(amount / 4) 时开始充值。停用时为 null。只读。

limits
object
必填

账户的金额限制。