Fügt Unterstützung für das Abrufen von Thin-Ereignissen hinzu
Das ändert sich
Sie können jetzt Thin-Ereignisobjekte für jede Benachrichtigung vom Endpoint /v2/core/events abrufen.
Thin-Ereignisse sind einfache Ereignisse, auf die Sie über die API v2 API zugreifen können. Thin-Ereignisse haben ein detaillierteres Berechtigungsmodell und ihre Nutzlasten enthalten keine API-Versionsdaten. Dies erleichtert die Aktualisierung von Integrationen, die Ereignisse empfangen und mit einem gut typisierten Stripe SDK erstellt wurden. Thin-Ereignisobjekte enthalten die Eigenschaft data, die weitere Informationen über das Ereignis enthalten kann.
Die Meters API ist die erste API, die Thin-Ereignisse verwendet. Derzeit können Sie nur die folgenden Ereignisse v2 im Zusammenhang mit der nutzungsbasierten Abrechnung abrufen:
Hier finden Sie ein Beispiel für das Ereignis v1.. Das Feld related_ enthält die id des Objekts, jedoch nicht den Objektdatensatz.
{ "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" } }
Weitere Informationen zu Ereignissen.
Auswirkungen
Thin-Ereignisse haben mehrere Vorteile. Sie erleichtern die Pflege zukünftiger Webhook-Integrationen, da die Nutzlasten nicht in Versionen vorliegen. Sie können Thin-Ereignisse an Ereignisziele senden. Thin-Ereignisse werden vollständig in die SDKs für API v2 eingegeben. Wenn Ihre Anwendung ein entsprechendes API-Objekt benötigt, das sich auf ein Ereignis bezieht (zum Beispiel das Zählerobjekt), müssen Sie die Stripe-API für den neuesten Status des Objekts aufrufen. Dies trägt dazu bei, Anwendungsfehler zu vermeiden, die durch veraltete Objektdaten verursacht werden (zum Beispiel Racebedingungen). Die SDKs für API v2 enthalten Hilfsmethoden, mit denen Sie Datensätze abrufen können, die einem Ereignis zugeordnet sind.