# Shell と API Explorer

実装の管理や API の確認には、コマンドラインインターフェイスを使用します。

Shell はワークベンチ内のコマンドラインインターフェイスであり、[Stripe CLI](https://docs.stripe.com/stripe-cli.md) で構築されているコマンドと同じコマンドを数多く提供しています。ワークベンチを使用する際は、画面の下部でいつでも最小限の Shell を使用できます。または、**Shell** タブを使用してフルスクリーンのセッションを起動することもできます。

次の Shell 機能を利用すると Stripe システムの管理とデバッグを行うことができます。

- **オートコンプリート機能**: Shell で Tab キーを押すと API リクエストと CLI コマンドの補完機能が働きます。
- **API Explorer:** 標準搭載されている API Explorer を使用すると、API リソースの詳細を確認しながら、Shell で API コールを構築できます。

> Shell はブラウザーで実行されるため、[Stripe CLI](https://docs.stripe.com/stripe-cli.md) と比べるといくつか制約があります。Stripe CLI では、ローカルのイベントリスナーを使用してローカルマシンで Webhook イベントの受信とトリガーを行うことができます。詳細は [Stripe CLI で Webhook との連携をテストする](https://docs.stripe.com/webhooks.md#test-webhook)をご覧ください。

## 初期セットアップ

[ダッシュボード](https://dashboard.stripe.com)にサインインします。**開発者**メニューで**ワークベンチ**をクリックします。**Shell** タブに切り替えます。

> Shell は本番環境では読み取り専用です。[サンドボックス](https://docs.stripe.com/sandboxes.md)に切り替えて、API オブジェクトを作成、変更、削除する API リクエストを実行します。

## イベントをリッスンする

1. コマンドラインプロンプトで、`stripe listen` と入力して [Webhook イベント](https://docs.stripe.com/event-destinations.md#events-overview)をリッスンしてから、キーボードの **Enter** を押してコマンドを実行します。

```bash
stripe listen
```

> これによって、Stripe アカウントの受信イベントをリッスンします。

## 最初の API リクエストを実行します。

1. **新しいペイン**をクリックすると、既存のセッションの横の画面に新しいセッションが開きます。
1. コマンドをコピーして、コマンドラインプロンプトに貼り付け、キーボードの **Enter** を押します。
1. 後続のリクエストのレスポンスで、(`id` 内の) オブジェクト ID をコピーします。

#### curl

```bash
stripe products create \
--name="Introductory offer (Monthly)" \
--description="$0.99 per month"
```

> これで、名前と説明を持つ商品が作成されます。

## API Explorer を使用する

1. **API Explorer** をクリックすると、右側にインタラクティブな API Explorer が表示されます。
1. `Products` リソースと `Update` メソッドを選択します。API Explorer に、 Products リソースの必須パラメーターとオプションのパラメーターが表示されます。
1. 前のステップからのオブジェクト ID を `id` パス引数の `Value` に貼り付けます。API Explorer で既存のオブジェクト ID を指定すると、その既存の商品のプロパティが読み込まれます。
1. オプションのパラメーター `description` を月額 1.99 USD に更新します。API Explorer によって、商品の説明を更新する API コマンドが Shell に自動的に表示されます。**Enter** キーを押してコマンドを実行し、商品を更新します。
1. **Print SDK code (SDK コードを出力する)** をクリックすると、選択した言語に対応するコードスニペットを確認できます。

## 利用可能なコマンド

Shell は `stripe` コマンドに加えて複数のコマンドを提供します ([Stripe CLI リファレンス](https://docs.stripe.com/cli.md)をご覧ください)。

| コマンド        | 目的                                                                         |
| ----------- | -------------------------------------------------------------------------- |
| `cd`        | 別のドキュメントページに移動します                                                          |
| `clear`     | shell から以前のテキストをすべて消去します                                                   |
| `ls`        | 現在のページに関連するダッシュボードページを一覧表示します                                              |
| `pwd`       | 現在のページのスラグとタイトルを出力します                                                      |
| `shortcuts` | Shell で使用できるキーボードショートカットを表示します                                             |
| `stripe`    | 利用可能な Stripe CLI コマンド ([リファレンスの全文](https://docs.stripe.com/cli.md)をご覧ください) |
| `whoami`    | ログインした加盟店の詳細を表示します                                                         |