跳到文档正文
浏览和搜索
本页内容

change_billing

准备一项订阅变更:套餐、周期、Instagram 或 Ultra Speed 账号额度、暂停、取消(报价会列出可用的挽留优惠)、挽留优惠、恢复、保留,或关闭自动续费。返回价格和日期;在 confirm_action 用发到对方邮箱的验证码执行之前,不会有任何变化。confirm 级:调用只会暂存并返回这项变更。request_confirmation_code 向对方邮箱发送验证码,对方读出验证码后,confirm_action 才会执行变更。同名 MCP 工具需要 tweetstream:billing 权限范围。

POST/api/agent/actions/change_billing

授权

  • Authorizationstringheader必填使用 TweetStream API 密钥进行 Bearer 认证:Bearer <key>。

请求体

  • changeobject必填
    • billingCycleenum<string>必填
    • kindenum<string>必填
    • planenum<string>必填
  • familyenum<string>必填

响应字段

  • nextobject必填
    • actionenum<string>必填
    • messagestring必填
    • namestring必填
    • whoenum<string>必填
  • pendingActionobject必填
    • actionstring必填
    • expiresAtstring必填a string to be decoded into a Date
    • idstring必填
    • quoteobject必填
      • amountDueCentsinteger必填an integer
      • effectiveAtstring必填a string to be decoded into a Date
      • renewalobject必填
        • amountCentsinteger必填an integer
        • atstring必填a string to be decoded into a Date
        • termMonthsinteger必填an integer
      • saveOfferobject必填
        • descriptionstring必填
        • offerobject必填
    • summarystring必填
  • statusenum<string>必填

响应

  • 200成功
  • 400输入不符合该操作的 schema(INVALID_REQUEST)
  • 401API key 缺失或无效
  • 403请求带有外部 Origin
  • 409没有需要变更的内容,或不提供该变更(ACTION_REFUSED,附带 reason)
  • 429已达到速率限制(RATE_LIMITED),请在 retryAfterSeconds 秒后重试
  • 503暂时不可用,请稍后重试