コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

はじめに

ヘッダーと認証

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

このページの内容

ベース URLs

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

認証ヘッダー

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

リクエストヘッダ
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json

鍵を検証する

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

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

既に設定されている場合はキー・スキップを設定します。
# 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
(
: "${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'
)

期待される応答

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

所有者の身元・イラスト応答の抜粋
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}

署名された貯蔵 URLs

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

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

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