Ajout d'une prise en charge de la récupération des événements légers

Nouveautés

Vous pouvez désormais récupérer des objets Thin Event pour chaque notification à partir de l’endpoint /v2/core/events.

Les événements légers sont des événements de faible ampleur auxquels vous pouvez accéder via l’API v2. Les événements légers ont un modèle d’autorisation plus détaillé et leurs charges utiles ne contiennent aucune donnée de la version API. Cela facilite la mise à jour des intégrations qui reçoivent des événements et sont construites avec un SDK Stripe bien saisi. Les objets Thin Event comprennent une propriété data qui peut inclure des informations supplémentaires sur l’événement.

L’API Meters est la première API à utiliser des événements légers. Actuellement, vous ne pouvez récupérer que les Événements v2 suivants liés à la facturation à l’usage :

• v1.billing.meter.error_report_triggered
• v1.billing.meter.no_meter_found

Voici un exemple d’événement v1.billing.meter.error_report_triggered. Le champ related_object contient l’identifiant id de l’objet, mais pas l’objet enregistré lui-même.

{
  "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"
  }
}

En savoir plus sur les événements.

Impact

Les événements légers présentent plusieurs avantages. Ils facilitent la maintenance des futures intégrations de webhook car les charges utiles ne sont pas versionnées. Vous pouvez envoyer des événements légers à des destinations d’événements. Les événements légers sont entièrement saisis dans les SDK pour l’API v2. Enfin, si votre application a besoin d’un objet API correspondant à un événement (par exemple, l’objet Meter), vous devez appeler l’API Stripe pour obtenir l’état le plus récent de l’objet. Cela permet d’éviter les erreurs d’application causées par des données d’objet obsolètes (du fait par exemple de conditions d’accès concurrentes). Les SDK pour API v2 contiennent des méthodes de support qui vous permettent de récupérer les enregistrements associés à un événement.

Modifications

Mise à niveau