シンイベントを取得するためのサポートを追加します
新機能
You can now retrieve thin Event objects for each notification from the /v2/core/events endpoint.
シンイベントは、API v2 API を介してアクセスできる軽量イベントです。シンイベントはより細かい権限モデルを使用し、そのペイロードには API バージョン管理されたデータは含まれません。これにより、イベントを受信し、適切に型付けされた Stripe SDK で構築された統合を簡単に更新できます。Thin Event オブジェクトには、イベントに関する追加情報を含めることができる data プロパティが含まれます。
Meters API は、Thin イベントを使用する最初の API です。現在取得できるのは、従量課金 に関連する次の Events v2 のみです。
v1. イベントの例を次に示します。related_ フィールドには、オブジェクトの id が含まれますが、オブジェクトレコード自体は含まれていません。
{ "id": "evt_test_65R9Ijk8dKEYZcXeRWn16R9A7j1FSQ3w3TGDPLLGSM4CW0", "object": "v2.core.event", "type": "v1.billing.meter.error_report_triggered", "livemode": false, "created": "2024-09-17T06:20:52.246Z", "related_object": { "id": "mtr_test_61R9IeP0SgKbYROOx41PEAQhH0qO23oW", "type": "billing.meter", "url": "/v1/billing/meters/mtr_test_61R9IeP0SgKbYROOx41PEAQhH0qO23oW" } }
イベントの詳細をご覧ください。
影響
シンイベントにはいくつかのメリットがあります。ペイロードのバージョン管理が行われないため、将来の Webhook の統合を維持しやすくなります。シンイベントを イベントの送信先 に送信できます。シンイベントは、API v2 の SDK ですべてタイプが指定されています。最後に、アプリケーションで対応するイベント関連の API オブジェクト (Meter など) が必要な場合は、Stripe API を呼び出してオブジェクトの最新の状態を取得する必要があります。この方法では、以前のオブジェクトデータに起因するアプリケーションエラー (競合状態など) を防止できます。API v2 の SDK には、イベントに関連するレコードを取得するヘルパーメソッドが含まれています。