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 abjects de type événements légers 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 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. À l’heure actuelle, vous pouvez uniquement récupérer 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 intégrations webhook futures, car les charges utiles ne sont pas versionnées. Vous pouvez envoyer des événements légers vers des destinations d’événements. Les événements légers sont entièrement typés dans les SDK pour l’API v2. Enfin, si votre application a besoin d’un objet API correspondant lié à un événement (par exemple, le compteur), vous devez appeler l’API Stripe pour obtenir le dernier état de l’objet. Cela permet d’éviter les erreurs d’application causées par des données d’objet obsolètes (par exemple, les conditions de concurrence). Les SDK pour l’API v2 contiennent des méthodes d’aide qui vous permettent de récupérer les enregistrements associés à un événement.

Modifications

Mise à niveau