# ヘッダーと認証

適切なホストと認証情報を使い、無料のリクエストでアクセスを確認します。

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/headers-and-authentication
レビュー: FlashData による 2026-11-04

<a id="requests"></a>

## ベース URLs

| 目的: | ベース URL | 認証 |
| --- | --- | --- |
| データクエリとジョブ | https://data.flashdata.dev/v1 | X-API-Key |
| アイデンティティ、バランス、価格設定、制限、使用 | https://api.flashdata.dev/v2 | X-API-Key |
| リモート MCP | https://data.flashdata.dev/mcp | ホスト管理 OAuth、または X-API-Key |


<a id="choose"></a>

## 認証ヘッダー

REST リクエストでは、試用キーまたは所有者キーを X-API-Key に指定します。JSON ボディには Content-Type: application/json を付けてください。CLI プロファイル、SDK の環境、MCP 接続はそれぞれ別に認証情報を保存します。

### REST / APIキー

#### リクエストヘッダ

```http
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json
```


### MCP / OAuth

MCPホストがログインしてこのトークンを取得、保存、更新しましょう。 MCPエンドポイントでのみ使用してください。 API キーを使用してホストは、代わりにX-API-Keyを送信します。

#### MCPホストが管理したヘッダ

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [API キーを取得する](https://flashdata.dev/ja/docs/guides/api-keys-and-permissions/reference.md)
- [MCPで接続](https://flashdata.dev/ja/docs/integrations/mcp-clients/reference.md)

<a id="check"></a>

## 鍵を検証する

端末でこれを実行します。 クレジットを使わずに、ID エンドポイントがアクセスをチェックします。 FLASHDATA_API_KEYが既に設定されている場合は、キープロンプトをスキップします。

### Bash / cURL

BashとcURL 7.76+が必要です。 環境がすでにFLASHDATA_API_KEYを供給している場合は、隠れたキープロンプトをスキップします。 同じターミナルで読み取りコマンドを実行します。

#### 既に設定されている場合はキー・スキップを設定します。

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

#### 口座を読む JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

FLASHDATA_API_KEYが既に設定されている場合は、隠しキープロンプトをスキップします。 同じターミナルで読み取りコマンドを実行します。

#### 既に設定されている場合はキー・スキップを設定します。

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

#### 口座を読む JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```



<a id="result"></a>

### 期待される応答

期待 HTTP 200。 対象アカウント、access: ready、およびスコープ内のソースを確認してください。 一時的なキーはaccountType: temporaryを持っています。 所有者の仕事を再帰することはrecurringAllowed: trueを要求します。

#### 所有者の身元・イラスト応答の抜粋

```json
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}
```

- [最初の API 呼び出し](https://flashdata.dev/ja/docs/guides/http-quickstart/reference.md#curl)

<a id="storage"></a>

## 署名された貯蔵 URLs

その結果、URLsをアップロードして、独自の承認が含まれています。 X-API-Key、OAuthトークンまたはブラウザクッキーなしで返されたURLに従ってください。


<a id="errors"></a>

## 認証のトラブルシューティング

| レスポンス | 次のステップ |
| --- | --- |
| 401 | この環境のキー、その満了と取消をチェックしてください。 現在の API キー、MCP トークン、またはベアラープレフィックスではなく、使用してください。 |
| 403 / ソース欠落 | 所有者にこのキーに必須のソースを付与するように依頼してください。 |
| 503 この無料読み込み中 | 後で読み直します。 口座のステータスが検証されていないため、有料のクエリが準備完了しているわけではありません。 |

