タスクの作成

このガイドでは、APIキーの作成と、FourA Dashboardを使用した最初のリクエストの送信手順を説明します。

ステップ 1: Dashboardを開く

Dashboardにアクセスし、FourAアカウントでサインインします。

ステップ 2: APIキーを作成する

API Keysページに移動し、Create API keyをクリックします。キーをすでに作成済みの場合は、リスト上部のボタン表示がCreate Keyに変わります。

キーにわかりやすい名前を付けます (例: "production-scraper" または "dev-testing")。API Key Createdダイアログにプレーンテキストのキーとコピー用ボタンが表示され、Test your first requestの下にはCopy commandが付いた実行可能なcurlコマンドが表示されます。スマートフォンやタブレットでは、代わりにTry it in the PlaygroundからPlaygroundへ移動できます。

この画面を閉じた後でも、キーの行にある目のアイコンをクリックすれば再表示できます。キー再表示機能のリリース前に作成された古いキーは再表示できないため、一度再生成して切り替えてください。完全な手順: APIキーの管理。

キーの形式は次のようになります: pk_live_a1b2c3d4e5f6...

ステップ 3: エンドポイントを選択する

FourAには、用途に応じた4つのエンドポイントがあります:

Auto (`POST /api/auto/`)

スマートなデフォルト設定です。URLとvalidateルールを渡すと、FourAがダイレクトrequest、ローテーションproxy、フルブラウザの中から最もコスト効率の良い動作経路を自動選択します。新しいサイトを対象としており、必要な処理がまだ分からない場合に最適です。

Single (`POST /api/single/`)

高速なHTTP requestを送信します。静的HTMLページやAPI endpointに最適です。レスポンス時間: 通常2秒未満。

Browser (`POST /api/browser/`)

Chromeブラウザインスタンスを実行してJavaScriptをレンダリングします。SPA、遅延読み込みコンテンツ、JS実行が必要なページに最適です。レスポンス時間: 2〜10秒。

Proxy (`POST /api/proxy/`)

自動リトライ機能を備えたローテーションproxy経由でリクエストをルーティングします。リクエスト元の検証を行うサイトや、国によって異なる応答を返すサイトに最適です。

ステップ 4: 最初のリクエストを送信する

ターミナルを開いて実行します:

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'

ステップ 5: レスポンスの読み取り

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<html>...</html>",
  "total_time": 0.45
}

headers フィールドはオブジェクトの配列で、リダイレクトホップごとに1つ含まれます。各エントリには、ステータスラインとターゲットから返されたすべての response header を含む result があります。

主要フィールド:

status: ターゲットサイトからの HTTP status code
data: response body (HTML、JSON、またはプレーンテキスト)
total_time: request の所要時間 (秒)

Step 6: ブラウザリクエストを試す

ターゲットページがコンテンツのレンダリングに JavaScript を使用している場合は、代わりに browser endpoint を使用します。

curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/products", "timeout_ms": 15000}'

ブラウザの response は data ではなく body を使用します:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

よくある問題

問題	解決策
使用するエンジンが不明	auto endpoint から開始してください。最適なパスを選択し、成功した設定を記憶します。
コンテンツが空	single から browser endpoint に切り替えてください。ページに JS レンダリングが必要な可能性があります。
レスポンスに検証ページが表示される	自動 IP ローテーションを行う proxy endpoint に切り替えてください。
タイムアウト	`timeout_ms` を増やすか、URL が正しいか確認してください。
キーを紛失した	API Keys のキーの行にある目のアイコンをクリックして表示するか、レガシーキーの場合は再生成してください。

次のステップ

ダッシュボードの概要: ダッシュボード全体のウォークスルー
Playground: コードを書く前にダッシュボードでリクエストをテスト
Smart Fetch (Auto): auto endpoint の詳細解説
最適なエンドポイントの選択: 詳細な比較
よくある問題: 問題を迅速に解決

最終更新日: 2026年9月30日