订阅
订阅功能定义通过 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 声明会拒绝所有者订阅操作，并且非所有者调用者将被阻止执行所有者范围内的订阅操作。上游代理失败作为显式操作失败返回，并且订阅突变仍然仅限于显式更改或取消路由。