為了幫助創作人在全球擴大會員人數, 不論創作人選擇哪種貨幣,訂閱會員都即將能使用我們支援的所有貨幣付款。有關APIv1和APIv2的記錄更新如下。有關Patreon支援貨幣的更多資訊,請瀏覽以下幫助中心文章: Patreon支援的貨幣
APIv1
為了確保使用Patreon API的開發人員能夠順暢轉用系統,我們正改善APIv1中的
貨幣
設定記錄。APIv1是用以計算閱會員所選用的貨幣。請注意,APIv1中的 貨幣
設定是按會藉資料自動產生的。例如,使用APIv1的開發人員會在一位以£5訂閱的會員的會籍資料中看到 貨幣:GBP
(GBP是英鎊的ISO貨幣代碼),以及現有的訂閱設定,例如 amount_cents:500
。請注意,APIv2中的 訂閱事件資源 顯示
currency_code
與APIv1中的 貨幣
相同 除了API文檔更新之外,我們還將向APIv1訂閱資源公開
狀態
設定。使用APIv1來限制和/或授予會員福利的開發人員現時可以檢查 狀態
設定 是否有效
(即狀態:有效
)並 參考 獎賞
(會員等級)關係,以了解訂閱會員是否已成功訂閱一個獨立於訂閱會員和創作人貨幣的會員等級。這種方法令我們無需比較訂閱會員的訂閱金額與某一會員等級上的欠款,從而避免管理貨幣匯率的開銷。實際上,你的APIv1請求將類似以下示例:
回應:

回應包括
獎賞
(創作人會員等級)的關係。請注意, 狀態
是選填項目,需另發請求。另請注意,如果你明確請求填寫欄目,將不會出現預設設定。
APIv2
為了限制使用APIv2的會員福利,我們建議開發人員使用會員 資源。開發人員可透過隱藏貨幣的方式檢查
patron_status
與 currently_entitled_tiers
按會員等級限制或授予瀏覽權限。要瀏覽這些設定,你的APIv2請求將如下填充:
並會獲得類似下列回應:

注意,已刪除的會員等級不會在
currently_entitled_tiers
關係中顯示。 需要瀏覽支持已刪除等級訂閱會員的APIv2開發人員可以參考 訂閱活動
來限制會員福利的發放。沒有APIv1是相等的,因此如果瀏覽已刪除的會員等級資訊十分重要,開發人員應該升級。總括而言,如果你在
訂閱會員
、訂閱活動
或訂閱
資源中使用 amount_cents
,系統一般會顯示訂閱會員的貨幣,而非獎賞等級或活動貨幣。上述更新讓APIv1和APIv2上的開發人員可授予瀏覽創作人福利的權限,也不必擔心訂閱會員和創作人之間的貨幣差異。如果你需要協助以善用這些更新,請瀏覽 docs.patreon.com/zh-hk。