订阅

订阅

订阅功能定义通过 Inbox Manager 代理路由公开的帐户所有者订阅和计划操作。 它为所有者提供了直接的计划生命周期控制，同时保持严格的帐户和角色检查。

为什么这很重要

此功能将所有者订阅操作整合到收件箱管理器 API 界面下，同时保留对不记名令牌声明的严格帐户和角色检查。它公开结帐、门户、同步和计划更改操作，而不需要客户端重复订阅编排逻辑。

核心流程

操作

运营	端点	目的
列出订阅	GET /api/subscriptions	检索所选令牌帐户的订阅
列出功能	GET /api/subscriptions/features	检索有效订阅功能集
获取订阅身份	GET /api/subscriptions/identity	获取账户订阅身份绑定
商户列表	GET /api/subscriptions/merchants	检索商家/提供商选项
同步订阅	POST /api/subscriptions/sync	从提供商刷新订阅状态
更改订阅	POST /api/subscriptions/:subscription_id/change	修改计划或间隔
取消订阅	POST /api/subscriptions/:subscription_id/cancel	结束订阅生命周期
创建结帐会话	POST /api/subscriptions/stripe/checkout-session	开始结帐新的或更改的计划
创建门户会话	POST /api/subscriptions/stripe/portal-session	打开自助订阅门户
同步结帐会话	POST /api/subscriptions/stripe/checkout-session-sync	将结帐完成链接到订阅状态

关键数据和状态

{
  data: {
    account_id: "acc_...",
    subscription_id: "sub_...",
    status: "active"
  },
  links: {
    checkout_url: "https://checkout.stripe.com/..."
  }
}

所有响应都使用代理信封样式的有效负载，由 data 和可选的 links 键入。

故障模式和控制

缺少或无效的 acc 声明会拒绝所有者订阅操作，并且非所有者调用者将被阻止执行所有者范围内的订阅操作。上游代理失败作为显式操作失败返回，并且订阅突变仍然仅限于显式更改或取消路由。

相关

订阅代理信封、11-订阅所有者控制。