Cas d'usage

Comprendre comment réaliser des tâches courantes de développeur avec Workbench.

Workbench fournit de nombreux outils pour les développeurs permettant de déboguer, de gérer et de développer leur intégration Stripe. Ces guides vous aident à comprendre comment réaliser les tâches courantes des développeurs.

Afficher les versions de l'API utilisées par les requêtes API

Lorsque vous envoyez des requêtes à Stripe, vous pouvez spécifier la version de l’API à l’aide de l’en-tête Stripe-Version. Si vous ne la précisez pas, Stripe utilise la version de l’API par défaut définie pour votre compte.

Ouvrez l’onglet Aperçu dans Workbench.
Consultez la section Versions d’API pour voir les requêtes effectuées au cours de la semaine passée.
La version de l’API par défaut définie pour votre compte est indiquée par Default. Toutes les requêtes effectuées par la dernière version de l’API sont indiquées par Latest.

Pour afficher la liste des versions, consultez la liste des modifications de l’API

Afficher les erreurs d'intégration récentes

Stripe regroupe automatiquement les erreurs d’intégration récentes par type d’erreur et par endpoint.

Ouvrez l’onglet Erreurs dans Workbench.
Dans le volet Erreurs récentes, sélectionnez la période sur laquelle vous souhaitez filtrer les erreurs.
Cliquez sur un groupe d’erreurs pour afficher le résumé précisant le nombre d’occurrences, l’endpoint d’API et la source de la requête.

Afficher les logs de requêtes API par méthode ou état HTTP

Suivez ces étapes pour filtrer les logs de requêtes API par méthode ou état HTTP.

Ouvrez l’onglet Logs dans Workbench.
Cliquez sur État pour filtrer les demandes dont l’état est Réussi ou En échec (consultez la liste complète des codes d’état HTTP renvoyés par Stripe).
Cliquez sur Appliquer.

Afficher les logs des requêtes API par source

Suivez ces étapes pour filtrer les logs de requêtes API par source. Les requêtes API peuvent provenir d’actions effectuées dans le Dashboard ou d’un appel à l’API direct (par exemple, à l’aide d’un SDK).

Ouvrez l’onglet Logs dans Workbench.
Cliquez sur Plus de filtres.
Dans Source, sélectionnez Dashboard ou API pour filtrer les requêtes par source.
Cliquez sur Appliquer.

Filtrer par ID de ressource

Lorsque vous créez, mettez à jour ou supprimez une ressource Stripe à l’aide des API Stripe, Stripe renvoie un ID de ressource dans la charge utile de la réponse. Par exemple, lorsque vous créez un client, Stripe renvoie un ID de client (dans le champ id), par exemple cus_ImZZa3EEvvQQQU. Suivez ces étapes pour filtrer les requêtes API par ID de ressource.

Ouvrez l’onglet Logs dans Workbench.
Saisissez l’ID de la ressource dans le champ de texte Filtrer par ressource et appuyez sur la touche Entrée de votre clavier.

Filtrer les événements

Procédez comme suit pour afficher les événements et leur charge utile d’objet Event.

Ouvrez l’onglet Événements dans Workbench.
Pour filtrer par événement, cliquez sur Type d’événement :
- Saisissez un nom d’événement, par exemple, payment_intent.created.
- Saisissez un événement avec le caractère de remplacement. Par exemple, payment_intent.*.
Cliquez sur Appliquer.