クリエイターがグローバルにメンバーシップを成長させるために、クリエイターが選択した通貨に 関係なく、パトロンはサポートされている通貨で支払うことができるようになります。APIv1とAPIv2の両方のドキュメントの更新については、以下を参照してください。Patreonのサポート通貨の詳細については、ヘルプセンターの記事「 Patreonのサポート通貨」をご覧ください。
APIv1
Patreon APIを使用して開発者がシームレスに移行できるよう、APIv1の
currency属性のドキュメントを改善しています。これにより、パトロンのサポート通貨が返されるようになります。API 1の currency属性は、デフォルトで会費リソースに返されることに注意してください。たとえば、APIv1を使用する開発者には、£5でサポートするパトロンの会費リソースで currency: GBP （GBPは英ポンドのISO通貨コード）と、 amount_cents: 500 などの既存の会費属性が見つかります。APIv2の 会費イベントリソースは、既にAPIv1の
currency と同じ currency_code を公開していることに注意してください。 APIドキュメントのアップデートに加えて、
status 属性をAPIv1会費リソースに公開します。APIv1を使用して特典へのアクセスを制限および/または許可する開発者は、 status 属性が valid （つまり、status: valid）であるかどうかを確認し、パトロンとクリエイターの通貨に関係なく、パトロンがランクへのサポートができたかどうかを確認するために reward （ランク）関係を参照できるようになりました。このアプローチにより、パトロンのサポート金額をランクでの支払い金額と比較する必要がなくなり、為替レートを管理するオーバーヘッドが回避されます。実際には、あなたのAPIv1リクエストは以下の例のようになります。
応答は次のようになります。
応答には
reward （クリエイターランク）関係が含まれます。 status はオプションフィールドであり、明示的にリクエストする必要があることに注意してください。また、フィールドを明示的にリクエストする場合、デフォルトの属性は返されませんのでご注意ください。
APIv2
APIv2を使用して特典へのアクセスをゲートするには、開発者がメンバーリソースを使用することをお勧めします。開発者は、
patron_status と current_entitled_tiers を確認して、通貨にとらわれない方法でランク別の特典へのアクセスを制限または許可することができます。これらの属性にアクセスするには、APIv2リクエストを次のように入力します。
以下のような応答が返されます。
削除されたランクは、
current_entitled_tiers 関係では返されません。削除されたランクをサポートするパトロンへのアクセスが必要なAPIv2 の開発者は、 PledgeEvent を参照して特典へのアクセスをゲートすることができます。APIv1に相当するものはないため、削除されたランク情報へのアクセスが重要なユースケースである場合、開発者はアップグレードする必要があります。つまり、
Member、PledgeEvent 、またはPledge リソースで amount_cents を使用する場合、返される値は常にパトロンの通貨であり、報酬ランクやキャンペーンの通貨ではありません。上記のアップデートにより、APIv1とAPIv2の両方の開発者は、パトロンとクリエイターの通貨の違いを気にすることなく、クリエイター特典へのアクセスを許可することができます。これらの最新アップデートを最大限に活用するためのサポートが必要な場合は、docs.patreon.comにアクセスしてください。