自动续订
Updated:
适用于所有类型的代理,包括住宅套餐。
权限:account:read,account:write,计费:撰写
calc_autoprolong_cost
🟢read-only · account:read
下一次自动扣款及其日期,内容保持不变。
返回: {total, discount, quantity, orders, balance, items[], days | tarifId, chargeDate, dateEnd, paymentId, autoProlong, warning, currency: "USD"}.items 是需要续期的代理(形式与list_proxies,password (已屏蔽),chargeDate 是指资金必须在账户余额中(null (用于住宅),autoProlong 显示每个选定代理是否已启用。当推断出该时间段时,periodId 以及一个_note 请指明具体是哪一个。已根据 2026-10-06 版本的 Stage API 进行验证。
enable_autoprolong
💳spends money · billing:write
开启自动续订功能。目前不会产生任何费用,但未来的续订将自动扣费。
参数 | 类型 | 描述 |
|---|---|---|
| 代理类型 | 产品类型 |
| 字符串 |
|
| 数组 | 哪些代理,按类型分类,例如make_prolong ( |
| 字符串 | 续订周期对应价格。可选:若已开启自动续订,则按绑定周期计价;否则,服务器将根据代理当前的运行周期(基于其租赁期限)进行计价,并在结果中注明该周期名称。 |
| 字符串 | 使用 |
| 字符串 | 仅限住宅用户——必须符合当前资费标准 |
| 字符串 | 促销代码 |
calc_autoprolong_cost 采用相同的参数。
返回: {autoProlong: true, quantity, ids[], orderIds[], days, paymentId, chargeDate, dateEnd, warning} ——实际上被启用了什么(用于ipv6 /mix /mix_isp (一次性下达整个订单);不存在total,使用calc_autoprolong_cost 关于数量。已根据 2026-10-06 版本的 Stage API 进行验证。使用paddle_subscription 且不subscriptionId:{status: "not_enabled", paddleSubscription: {cardConnected, subscriptionId?, card?, nextSteps}} 且内容保持不变。
常见错误: 非空warning 意为自动续订正在进行中 但余额不足以支付下一笔费用——请在chargeDate。使用paddle_subscription 且无卡牌关联,结果为status: "not_enabled",内容保持不变。
disable_autoprolong
🟡changes account state · account:write
关闭自动续订功能。代理服务将保持有效直至当前到期日。
参数 | 类型 | 描述 |
|---|---|---|
| 代理类型 | 产品类型 |
| 数组 | 哪些代理,按类型分类,例如make_prolong ( |