# Cas d'usage

Utilisez Workbench pour réaliser des tâches courantes de développeur.

[Workbench](https://docs.stripe.com/workbench.md) 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](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api) définie pour votre compte.

1. Ouvrez l’onglet [Aperçu](https://dashboard.stripe.com/workbench/overview) dans Workbench.
1. Consultez la section **Versions d’API** pour voir les requêtes effectuées au cours de la semaine passée.
1. 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](https://docs.stripe.com/upgrades.md#api-versions)

## 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.

1. Ouvrez l’onglet [Erreurs](https://dashboard.stripe.com/workbench/errors) dans Workbench.
1. Dans le volet **Erreurs récentes**, sélectionnez la période sur laquelle vous souhaitez filtrer les erreurs.
1. 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.

1. Ouvrez l’onglet [Logs](https://dashboard.stripe.com/workbench/logs) dans Workbench.
1. Cliquez sur **État** pour filtrer les requêtes dont l’état est **Réussi** ou **En échec**. (consultez la [liste complète des codes d’état HTTP](https://docs.stripe.com/error-low-level.md#status-codes) renvoyés par Stripe).
1. 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 direct à l’API (par exemple, à l’aide d’un SDK).

1. Ouvrez l’onglet [Logs](https://dashboard.stripe.com/workbench/logs) dans Workbench.
1. Cliquez sur **Plus de filtres**.
1. Dans **Source**, sélectionnez **Dashboard** ou **API** pour filtrer les requêtes par source.
1. 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](https://docs.stripe.com/api/customers/create.md), 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.

1. Ouvrez l’onglet [Logs](https://dashboard.stripe.com/logs) dans Workbench.
1. 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.

1. Ouvrez l’onglet [Événements](https://dashboard.stripe.com/events) dans Workbench.
1. 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.*`.
1. Cliquez sur **Appliquer**.

## Afficher les erreurs d’exécution d’un workflow

Vous pouvez utiliser Workbench pour inspecter l’exécution d’un [workflow](https://docs.stripe.com/workflows.md). Cliquez sur une étape du flux de travail dans le Dashboard pour en consulter les détails, ou ouvrez-la dans Workbench à des fins d’inspection. Pour en savoir plus, consultez la section [Configurer un workflow](https://docs.stripe.com/workflows/set-up.md#observe-workflow).

## Afficher les détails d’exécution de l’extension

Affichez l’état, les entrées et les sorties de vos exécutions d’extension afin de déboguer les problèmes ou de vérifier le comportement attendu.

1. Ouvrez l’onglet [Extension Runs](https://dashboard.stripe.com/workbench/extension-runs) (Exécutions d’extension) dans Workbench.
1. Consultez la liste des exécutions récentes, notamment leur état et leurs horodatages.
1. Sélectionnez une exécution pour en afficher les détails, notamment les données d’entrée et de sortie, ainsi que les erreurs.

Pour afficher les exécutions d’extension associées à un objet spécifique, ouvrez son inspecteur dans le Dashboard.