跳转到主要内容
PATCH
更新订阅

更新订阅

更改订阅的设置、暂停或恢复订阅,或将其迁移到另一个地址。只需发送要更改的字段,其余保持不变。更改立即生效:每次编辑之后我们都会重新检查该订阅。需要 buy_bandwidth 权限。

路径参数

number
必填
订阅 ID——创建或列出订阅返回的 id

请求体

boolean
false 暂停订阅:我们会收回带宽,并在您恢复之前不收取任何费用。true 恢复已暂停或已停止的订阅;与创建时一样,您的余额必须足以支付 24 小时和一笔转账。被客服关闭的订阅(stopped_reason: "admin")无法通过此方式恢复。
number
新的带宽数量。范围 1 至 5,000。在已付费的一天内提高它,会收取当天剩余时间的差额。
string
将订阅迁移到另一个地址。我们先从旧地址收回带宽,再向新地址委托;迁移完成之前,address_change_to 会显示该迁移。新地址要通过与创建时相同的检查。发送当前地址会取消尚未完成的迁移。
string
"USDT"、"TRX"、"USDD"、"CUSTOM" 或 "OWN"。切换到 USDT、TRX 或 USDD 会移除 contract。
string | null
来自您的代币列表的合约,用于 CUSTOM 或 OWN。null 将其移除(CUSTOM 时不可)。
string | null
新的标签,最多 50 个字符。null 或空字符串将其移除。
boolean
开启或关闭自动暂停。
number
新的免费带宽水平,范围与创建时相同。
boolean
开启或关闭免费带宽通知。
boolean
true 在其代币的下一笔转账之后暂停订阅,从现在起计。false 取消该设置。

响应

更新后的订阅,字段与列出订阅中的相同。

示例

暂停订阅:
Response
带宽被收回后,delegated_bw 会在几秒之内降为 0。

错误