# 最初の Stripe API リクエストを送信する Stripe API の使用を開始します。 Stripe API に対するすべてのコールには、API シークレットキーを含める必要があります。Stripe アカウントを作成すると、*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)および*本番* (Use this mode when you’re ready to launch your app. Card networks or payment providers process payments)環境でのテスト用に、クライアント側の公開可能キーとサーバー側のシークレットキーからなる 2 組の [API キー](https://docs.stripe.com/keys.md)が生成されます。本番環境のキーを使用して実際の資金移動を開始するには、[Stripe アカウントを設定する](https://docs.stripe.com/get-started/account/set-up.md)必要があります。 ## はじめに このガイドでは、Stripe API の簡単な操作で顧客を作成する方法についてステップごとに説明します。Stripe API オブジェクトとその連携方法について詳しくは、[API ツアー](https://docs.stripe.com/payments-api/tour.md)もしくは、[API リファレンス](https://docs.stripe.com/api.md)をご覧ください。決済の受け付けを開始する準備ができたら、[クイックスタート](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)をご覧ください。 ## 最初の API リクエストを送信する [Stripe Shell](https://docs.stripe.com/workbench/shell.md) を使用して Stripe API を探索できます。Stripe Shell では、Stripe ドキュメントサイトから Stripe CLI コマンドを直接実行できます。*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)環境でのみ動作するため、資金の移動を伴う実際の取引が開始されることはありません。 1. Stripe Shell を使用して[顧客を作成](https://docs.stripe.com/api/customers/create.md)するには、次のコマンドを入力します。 #### bash ```bash stripe customers create --email=jane.smith@email.com --name="Jane Smith" --description="My First Stripe Customer" ``` すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。 #### bash ```json { "id": "cus_LfctGLAICpokzr", // ID は次のようになります。 "object": "customer", // このオブジェクトがアカウントのログに記録されます。 "address": null, "balance": 0, "created": 1652283583, "currency": null, "default_source": null, "delinquent": false, "description": "My First Stripe Customer", "discount": null, "email": "jane.smith@email.com", "invoice_prefix": "9B1D61CF", "invoice_settings": { "custom_fields": null, "default_payment_method": null, "footer": null }, "livemode": false, "metadata": { }, "name": "Jane Smith", "next_invoice_sequence": 1, "phone": null, "preferred_locales": [ ], "shipping": null, "tax_exempt": "none", "test_clock": null } ``` 2. (オプション) サンドボックスで API シークレットキーを渡して、同じコマンドを実行します。 #### bash ```bash stripe customers create --email=jane.smith@email.com --name="Jane Smith" --description="My First Stripe Customer" --api-key sk_test_BQokikJOvBiI2HlWgH4olfQ2 ``` すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。 #### bash ```json { "id": "cus_LfdZgLFhah76qf", // ID は次のようになります。 "object": "customer", // このオブジェクトがアカウントのログに記録されます。 "address": null, "balance": 0, "created": 1652286103, "currency": null, "default_currency": null, "default_source": null, "delinquent": false, "description": "My First Stripe Customer", "discount": null, "email": "jane.smith@email.com", "invoice_prefix": "D337F99E", "invoice_settings": { "custom_fields": null, "default_payment_method": null, "footer": null }, "livemode": false, "metadata": { }, "name": "Jane Smith", "next_invoice_sequence": 1, "phone": null, "preferred_locales": [ ], "shipping": null, "tax_exempt": "none", "test_clock": null } ``` ## ログとイベントを表示する Stripe API を呼び出すたびに、Stripe はStripe [ユーザーアカウント](https://docs.stripe.com/get-started/account.md)の API オブジェクトと [Events](https://docs.stripe.com/api/events.md) オブジェクトを作成・保存します。リクエストに指定する API キーによって、オブジェクトがサンドボックス環境に保存されるか、本番環境に保存されるかが決まります。たとえば、前回のリクエストで API シークレットキーが使用されていると、Stripe はオブジェクトをサンドボックスに保存します。 - API リクエストログを表示するには、以下を行います。 - [ログ](https://dashboard.stripe.com/test/workbench/logs)ページを開きます。 - **200 OK POST /v1 customers** をクリックします。 - イベントログを表示するには、以下を行います。 - [イベント](https://dashboard.stripe.com/test/workbench/events)ページを開きます。 - **jane.smith@email.com is a new customer** をクリックします。 ## API キーを保存する Stripe アカウントに登録すると、3 種類の API キーが作成されます。 | タイプ | 安全に公開可能 | 説明 | | --- | --- | --- | | 制限付き API キー (RAK)`rk_...` | いいえ | 権限を制御できる API キーです。キーが悪意のある第三者に取得された場合の事業への影響を最小限に抑えられます。必要な数だけ RAK を作成し、アプリケーションの各部分に割り当てることが可能です。RAK の設定と使用方法については、[こちらのガイド](https://docs.stripe.com/keys/restricted-api-keys.md)をご覧ください。 | | 公開可能 API キー | はい | フロントエンドコードや配布するアプリケーションに使用できる API キーです。 | | シークレット API キー `sk_...` | いいえ | すべての Stripe API に対して無制限の権限を持つ API キーです。権限を制限できないため、新しいユースケースでシークレットキーを使用することは推奨しておらず、既存の実装については、シークレットキーの使用を RAK に移行することを推奨しています。 | | 組織 API キー`sk_org_...` | いいえ | 組織レベルで機能する API キー。アカウントレベルの制限付きキーまたはシークレットキーと同様ですが、[組織](https://docs.stripe.com/get-started/account/orgs.md)レベルで動作し、複数の Stripe アカウントを一括管理できます。[こちらのガイド](https://docs.stripe.com/keys/organization-api-keys.md)では、組織 API キーの設定方法と使用方法について説明しています。 | 一部のホスティングプラットフォームが発行する[マネージド API キー](https://docs.stripe.com/keys/managed-api-keys.md)もサポートしています。マネージドキーは、ホスティングプラットフォームがホストされたアプリケーションに直接提供するシークレット API キーです。マネージドキーを直接扱う必要はなく、ホスティングプロバイダーが発行とローテーションを行います。 > #### Webhook 署名シークレット > > Webhook 署名シークレットは API キーではなく、Webhook ごとのシークレットであり、Webhook の受信側がその Webhook が実際に Stripe から送信されたことを認証するために使用します。各 Webhook エンドポイントの署名シークレットは、ダッシュボードの [Webhooks](https://dashboard.stripe.com/webhooks) セクションで確認できます。 2026 年 5 月より前に Stripe アカウントを作成した場合、制限付き API キーがない可能性があります。RAK を作成し、シークレットキーから移行することを推奨します。 API キーを安全に管理する責任は、お客様にあります。[API キーを保護するためのベストプラクティス](https://docs.stripe.com/keys-best-practices.md)に関するガイドをご覧ください。 ## See also - [開発環境を設定する](https://docs.stripe.com/get-started/development-environment.md) - [Stripe Shell](https://docs.stripe.com/workbench/shell.md)