ワークベンチ

ワークベンチを使用するには、Stripe アカウントが必要です。管理者または開発者の役割を持つユーザーのみが、ワークベンチのすべてのツールを利用できます。

1. ダッシュボードにサインインします。開発者メニューでワークベンチをクリックします。
2. ワークベンチペインの上部のハンドルをドラッグしてサイズを再指定したり、最大化アイコン () をクリックすることで、全画面モードを終了したり開始できます。
3. 最小化アイコン () をクリックして、ワークベンチをページ下部のタスクバーに縮小したり、展開アイコン () をクリックしてペインを再度開きます。タスクバーでは API オブジェクトをすぐに調べることができ、また重要な API エラーとイベントアクティビティーについて警告する通知トレイが含まれています。
4. ワークベンチのタスクバーを非表示にするには、縮小アイコン () をクリックし、ダッシュボードの右側のアイコンにタスクバーを最小化します。アイコンの上にマウスのカーソルを置くと、通知トレイが表示されます。アイコンをクリックすると、再び全画面のワークベンチペインが開きます。

ワークベンチの各タブには複数のツールが含まれています。各タブの機能と使用方法について、以下で詳細をご覧ください。

ワークベンチツールを使用する

ワークベンチを使用する際は、次のツールを覚えておいてください。

• リンクをコピーをクリックして、現在のワークベンチビューの共有可能な URL を生成します。
• フィードバックを送信をクリックして、コア開発チームとアイデアや質問を共有します。

概要タブで、アカウントの API アクティビティーの概要を確認します。

• API キーウィジェットには、アカウントの標準および制限付きのキーのリストが表示されます。管理をクリックして、API キーを作成または更新します。
• API バージョンウィジェットには、お客様のアカウントへの最近の API リクエストで指定された API バージョンの内訳が表示されます。アップグレードが可能をクリックして、Stripe アカウントのデフォルト API バージョンをアップグレードします。
• API リクエストと Webhook グラフは、アカウントでの最近の API アクティビティーを視覚化します。ドロップダウンから期間を選択すると、グラフが更新されて、その期間が反映されます。
• 最近のエラーには、Stripe アカウントでの最近のエラーの概要が示されます。

概要タブには、アカウントの API アクティビティーのスナップショットが表示されます。

エラータブには、Stripe アカウントに対する最近のエラーがまとめられています。各タイプの API エラーの解消方法を参照し、各エラーへの最近の API リクエストログを確認できます。ドロップダウンから期間を選択して、その期間中のエラーを確認できます。

エラータブには、最近の API エラーがまとめられ、関連するリクエストログが示されています。

左側のペインでは、API エラーがエラータイプごとにグループ化されています。エラーのグループを選択して、エラーの詳細とシステムへの影響の詳細をご覧ください。

• 発生数の数は、指定された期間中にこのエラーが発生した頻度を示しています。
• パスには、このエラーの原因となったリクエストで使用された API エンドポイントが示されます。
• ソースには、このエラーの原因となったリクエストで使用されたユーザーエージェントが示されます。
• ログセクションには、指定された API エラーのリクエストログの概要が示されます。いずれかをクリックすると、リクエストタブに詳細が表示され、関連するリクエストログの詳細なビューが表示されます。

検査機能を使用して、Stripe アカウントに含まれる API オブジェクトの JSON ビューの詳細を確認します。オブジェクトを調査するには、次の手順を実行します。

• 検査機能タブで、オブジェクト ID を入力します。
• 任意のオブジェクト (たとえば、Payment、Customer、Subscription) のダッシュボードに移動して、検査機能アイコン () をクリックするか、ワークベンチの検査機能タブを開きます。

検査機能には、API オブジェクトの JSON ビューと、関連する API オブジェクト、リクエストログ、イベントが表示されます。

API オブジェクトを検査する際、検査機能によって詳細が表示されます。

• 左側のペインには、関連する API オブジェクトの階層を示すデータマップが表示されます。
• 概要タブには、オブジェクトの JSON ビューが表示されます。
• ログタブには、オブジェクトに関連するリクエストログが表示されます。
• イベントタブでは、最近生成されたオブジェクト関連のイベントがまとめられています。

テスト環境またはサンドボックスを使用する場合、API Explorer で編集するを使用すると、API オブジェクトが API Explorer の Shell タブに事前に読み込まれます。ここから、API プロパティーを更新してオブジェクトを変更することができます。

自動検査トグルが有効になっている場合、検査機能は自動的に更新されて、ダッシュボードを表示すると、現在表示できるオブジェクトが表示されます。

ログタブには、Stripe アカウントでの最近の API リクエストとレスポンスが含まれています。ワークベンチには、最近のエラーとその解決方法に関する推奨事項がまとめられています。以下で API リクエストを絞り込むことができます。

• リクエスト日
• HTTP ステータス (例: 200)
• HTTP メソッド (例: POST または DELETE)
• API エンドポイント (例: /v1/checkout/sessions)
• リクエストを作成した IP アドレス
• ソース (ダイレクト API リクエストまたはダッシュボード)
• アカウント (または Connect の使用時は、プラットフォームまたは連結アカウント)
• API バージョン (例: 2020-08-27)
• エラーコード (例: resource_missing)
• エラータイプ (例: invalid_request_error)
• エラーパラメーター (例: line_items[*][price])

ワークベンチは、アカウントが新しい API リクエストを受信したときに、リアルタイムではこのタブを自動更新しません。ログを更新するをクリックして、Stripe アカウントから最新のリクエストログを取得します。

ログツールは、API アクティビティーのタイムラインを、タイムエンドポイント、レスポンスコード、その他のプロパティによるフィルター付きで表示します。

イベントタブには、Stripe アカウントでの最近のイベントのリストが含まれています。イベントを更新するをクリックして、Stripe アカウントから最新のイベントを取得します。以下の項目でイベントを絞り込むことができます。

• イベント日
• 送信ステータス (送信済みまたは失敗)
• イベントタイプ (例: customer.subscription.created、またはワイルドカード (例: customer.*) を使用することもできます)。
• API リソース (例: cus_123)

イベントタブには Stripe アカウントの最近のアクティビティーが表示されます。イベントは Webhook に送信できます。

左側のリストからイベントをクリックして、右側でイベントの詳細、ペイロード、試行された送信を確認します。

• 成功または失敗タブを選択して、配信の試行を特定のイベントで絞り込みます。
• オーバーフローメニュー () で、Webhook エンドポイントを表示をクリックして、このイベントの送信先を確認します。
• 配信の試行で再送するをクリックして、そのイベントを Webhook エンドポイントに再送します。

ワークベンチで Webhook エンドポイントを管理する方法をご覧ください。

Webhook タブで、Stripe がイベントを送信する新しい Webhook エンドポイントを作成できます。

• Webhook を使用する URL エンドポイント
• Stripe CLI を使用するローカルマシン

新しいエンドポイントを作成する

新しいエンドポイントを作成するをクリックして、Stripe がイベントを送信する新しい Webhook エンドポイントを設定します。Stripe が Webhook イベントの生成に使用する API バージョンと、リッスンするイベントタイプを選択し、サーバーが Webhook エンドポイントをホストする HTTPS URL を指定します。

ワークベンチの左側には、設定済みの Webhook エンドポイントが一覧表示されます。概要には、その設定済みのエンドポイントでのアクティビティーがまとめられ、イベントの送信先には Stripe からそのエンドポイントへのイベント送信の試行の一覧が表示されます。送信の試行の横にある今すぐ再試行をクリックすると、Stripe はそのエンドポイントにイベントを再送信できます。

新しい Webhook エンドポイントを設定するか、イベントをローカル開発マシンに振り分けます。

Shell はワークベンチ内で Stripe のリソースを管理するための、Stripe CLI に似たコマンドラインインターフェイスを提供します。利用可能なコマンドの一覧については、Shell と API Explorer をご覧ください。

ワークベンチの使用時に、いつでも最小化された Shell をペインで利用できますが、Shell タブを使用して全画面のセッションを起動することもできます。Shell タブで新しいペインをクリックして、複数のシェルセッションにペインを分割します。

API Explorer をクリックすると、インタラクティブなコマンドビルダーが右側に表示されます。API リソースと HTTP メソッドを選択して、対象のリクエストの必須とオプションのパラメーターを表示します。ヘッダータブでは、連結アカウントへの API リクエストを実行できるようにする Stripe-Account ヘッダーなど、いくつかの HTTP ヘッダーを設定できます。実行をクリックして、API リクエストを実行します。

API Explorer にパラメーターを入力すると、対応する Shell コマンドが自動的に構築されます。プログラミング言語を選択して、SDK リクエストを出力するをクリックし、API リクエストに対応する SDK コードを確認します。

Shell と API Explorer は、ワークベンチから Stripe の API を試行するのに役立ちます。