# Stripe-Context ヘッダー

関連するアカウントに対して API 操作を実行します。

デフォルトでは、API リクエストは、付随する [API キー](https://docs.stripe.com/keys.md)を生成した Stripe アカウントで実行されます。ただし、`Stripe-Context` ヘッダーを使用して、関連するアカウントのコンテキストで API リクエストを実行することは可能です。

> `Stripe-Context` ヘッダーは `Stripe-Account` ヘッダーよりも優先されるため、[連結アカウントに対する API 操作の実行](https://docs.stripe.com/connect/authentication.md)が容易になります。`Stripe-Context` によって、アクセスできる関連アカウントの範囲と種類が拡張されます。

## API リクエストの範囲

次のように、さまざまなスコープ内で実行される API リクエストを作成できます。

- 自分のアカウント
- プラットフォームの任意の連結アカウント
- 加盟店または受取人の設定を含む任意の v2 アカウント
- 組織内の任意のアカウント

API キーの所有アカウント以外のアカウントに API リクエストを行う場合は、`Stripe-Context` ヘッダーを含めて対象のアカウントを指定する必要があります。この値は、リクエストに使用した [API キー](https://docs.stripe.com/keys.md)と対象アカウントの相対関係によって異なります。

さまざまな事業を代表するプラットフォームアカウントを複数持つ組織を例に考えてみましょう。各プラットフォームには連結アカウントがあり、さらに各連結アカウントには受取人アカウントがあります。

各事業 (連結アカウント) を代表するスタンドアロンのプラットフォームアカウントを複数持つ組織。 (See full diagram at https://docs.stripe.com/context)

```text
[Rocket, Inc.組織 org_1234] --> [Rocket Ridesプラットフォーム acct_111]
[Rocket, Inc.組織 org_1234] --> [Rocket Repairsプラットフォーム acct_222]
[Rocket, Inc.組織 org_1234] --> [Rocket Deliveriesプラットフォーム acct_333]
[Rocket Ridesプラットフォーム acct_111] --> [Driver Smith連結アカウント acct_111a]
[Rocket Repairsプラットフォーム acct_222] --> [Mechanic Jones連結アカウント acct_222a]
[Rocket Deliveriesプラットフォーム acct_333] --> [Courier Vega連結アカウント acct_333a]
[Driver Smith連結アカウント acct_111a] --> [Fuel City受取人アカウント acct_111b]
```

このビジネス構造では、さまざまなスコープを使用して API リクエストを実行できます。次の表は、リクエストした API キーを所有するアカウントとの関係に基づいてコンテキストが必要になるスコープの `Stripe-Context` 形式を示しています。

| リクエストした API キーの所有者 | アカウントのスコープ | Stripe-Context 形式 |
| --- | --- | --- |
| Rocket, Inc. | Rocket Rides | プラットフォーム ID: `acct_111` |
| Rocket, Inc. | Driver Smith | プラットフォーム ID / 連結アカウント ID: `acct_111/acct_111a` |
| Rocket Rides | Driver Smith | 連結アカウント ID: `acct_111a` |
| Rocket Deliveries | Courier Vega | 連結アカウント ID: `acct_333a` |
| Rocket Rides | Fuel City | 連結アカウント ID / 受取人 ID: `acct_111a/acct_111b` |