# ユースケース

ワークベンチを使用して、一般的な開発者タスクを実行します。

[ワークベンチ](https://docs.stripe.com/workbench.md)には、開発者が Stripe システムのデバッグ、管理、拡張を行うためのツールが数多く用意されています。これらのガイドは、一般的な開発者の作業の方法を理解する上で役立ちます。

## API リクエストで使用される API バージョンを表示する

Stripe にリクエストを送信するときに、`Stripe-Version` ヘッダーで API バージョンを指定できます。API バージョンを指定しない場合は、アカウントの[デフォルトの API バージョン](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api)が使用されます。

1. ワークベンチの[概要](https://dashboard.stripe.com/workbench/overview)タブを開きます。
2. **API バージョン**セクションを調べて、先週のリクエストを確認します。
3. アカウントのデフォルトの **API バージョン**には、ラベル (デフォルト) が表示されます。最新の API バージョンを使用して行われたリクエストには、ラベル (最新) が表示されます。

バージョンのリストを確認するには、[API の変更ログ](https://docs.stripe.com/upgrades.md#api-versions)をご覧ください

## 最近の実装エラーを表示する

Stripe は、エラータイプとエンドポイントごとに最近の導入エラーをグループ化します。

1. ワークベンチの[エラー](https://dashboard.stripe.com/workbench/errors)タブを開きます。
2. **最近のエラー**ペインで、エラーを絞り込む期間を選択します。
3. エラーのグループをクリックすると、発生回数、API エンドポイント、リクエストソースを説明する**概要**が表示されます。

## HTTP メソッドまたはステータス別に API リクエストログを表示する

以下のステップを使用して、API リクエストログを HTTP メソッドまたはステータスで絞り込みます。

1. ワークベンチの[ログ](https://dashboard.stripe.com/workbench/logs)タブを開きます。
2. **ステータス**をクリックして、**成功**または**失敗**のリクエストをフィルタリングします。(Stripe が返す [HTTP ステータスコードの完全なリスト](https://docs.stripe.com/error-low-level.md#status-codes)はこちらでご覧いただけます。)
3. **適用**をクリックします。

## ソース別に API リクエストログを表示する

次の手順に従い、ソースごとに API リクエストログをフィルター処理します。API リクエストは、ダッシュボードでの操作、または API コール (SDK の使用など) によって開始できます。

1. ワークベンチの[ログ](https://dashboard.stripe.com/workbench/logs)タブを開きます。
2. **フィルターを追加**をクリックします。
3. **ソース**で、**ダッシュボード**または **API** を選択して、リクエストをソースで絞り込みます。
4. **適用**をクリックします。

## リソース ID で絞り込む

Stripe API を使用して、Stripe リソースを作成、更新、または削除すると、レスポンスペイロードでリソース ID が返されます。たとえば、[顧客を作成](https://docs.stripe.com/api/customers/create.md)すると、`cus_ImZZa3EEvvQQQU` などの顧客 ID が (`id` フィールドに) 返されます。以下のステップを使用して、リソース ID で API リクエストを絞り込みます。

1. ワークベンチの[ログ](https://dashboard.stripe.com/logs)タブを開きます。
2. **リソース ID でフィルター**テキストフィールドにリソース ID を入力して、キーボードの **Enter** を押します。

## イベントを絞り込む

以下の手順に従って、イベントと、そのイベントオブジェクトのペイロードを確認します。

1. ワークベンチの[イベント](https://dashboard.stripe.com/events)タブを開きます。
2. イベントで絞り込むには、**イベントタイプ**をクリックします。
   - イベント名を入力します。例: `payment_intent.created`。
   - ワイルドカード文字を含めてイベント名を入力します。例: `payment_intent.*`。
3. **適用**をクリックします。

## ワークフローの実行エラーの確認

Workbench を使用して、[ワークフロー](https://docs.stripe.com/workflows.md)の実行状況を調べることができます。ダッシュボードでワークフローのステップをクリックして詳細を表示するか、Workbench でステップを開いて詳細を調べます。詳しくは、[ワークフローの設定](https://docs.stripe.com/workflows/set-up.md#observe-workflow)をご覧ください。

## 拡張機能の実行詳細を確認する

問題のデバッグや期待どおりの動作を確認するために、拡張機能の実行ステータス、入力、出力を確認できます。

1. ワークベンチの[拡張機能の実行](https://dashboard.stripe.com/workbench/extension-runs)タブを開きます。
2. 最近の拡張機能の実行一覧を確認し、ステータスとタイムスタンプをチェックします。
3. 実行を選択すると、入出力データ、エラーなどの詳細が表示されます。

特定のオブジェクトの拡張機能の実行を表示するには、ダッシュボードでそのオブジェクトのインスペクタを開きます。