訂閱
訂閱功能定義透過 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 聲明會拒絕所有者訂閱操作，並且非所有者呼叫者將被阻止執行所有者範圍內的訂閱操作。上游代理失敗會作為明確操作失敗返回，訂閱突變仍然僅限於明確變更或取消路由。