タスクの作成

このガイドでは、FourAダッシュボードを使用してAPI keyを作成し、最初のリクエストを送信する手順を説明します。

ステップ1: ダッシュボードを開く

ダッシュボードに移動し、FourAアカウントでサインインします。

ステップ2: API keyの作成

API Keysページに移動し、Create Keyをクリックします。

keyにわかりやすい名前(例: "production-scraper"や"dev-testing")を付けます。確認ダイアログには、コピーボタンと共にプレーンなkeyが表示されます。

見逃した場合は、後でkeyの行にある目のアイコンをクリックして再表示できます。表示機能のリリース前に作成されたレガシーkeyは再表示できないため、一度再生成して切り替えてください。詳細な手順: API keyの管理。

keyは次のようになります: pk_live_a1b2c3d4e5f6...

ステップ3: endpointの選択

FourAには様々なシナリオに対応する4つのendpointがあります:

Auto (`POST /api/auto/`)

スマートなデフォルトです。URLとvalidateルールを渡すと、FourAは直接リクエスト、ローテーティングproxy、フルブラウザの中から機能する最も安価なパスを選択します。新しいサイトを対象としており、何が必要かまだ分からない場合に最適です。

Single (`POST /api/single/`)

高速なHTTPリクエストを送信します。静的な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つです。各エントリには、ステータス行とターゲットが返したすべてのレスポンスheaderを含むresultがあります。

主要なフィールド:

status: ターゲットサイトからのHTTPステータスコード
data: レスポンスボディ(HTML、JSON、またはプレーンテキスト)
total_time: リクエストの所要時間(秒)

ステップ6: ブラウザリクエストを試す

ターゲットページがJavaScriptを使用してコンテンツをレンダリングする場合は、代わりにブラウザの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}'

ブラウザのレスポンスは、dataの代わりにbodyを使用します:

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

よくある問題

問題	解決策
どのエンジンを使用すべきか分からない	Auto endpointから始めます。適切なパスを選択し、機能したものを記憶します。
コンテンツが空	SingleからBrowserのendpointに切り替えます。ページはJSのレンダリングを必要としている可能性があります。
レスポンスにCAPTCHAが含まれる	自動IPローテーションのためにProxy endpointに切り替えます。
タイムアウト	`timeout_ms`を増やすか、URLが正しいか確認します。
keyを紛失した	API Keysのkeyの行にある目のアイコンをクリックして表示するか、レガシーkeyの場合は再生成します。

次のステップ

ダッシュボードの概要: ダッシュボード全体の解説
プレイグラウンド: コードを書く前にダッシュボードでリクエストをテストする
スマートフェッチ(Auto): Auto endpointの詳細
適切なendpointの選択: 詳細な比較
よくある問題: 問題を素早く解決する

最終更新日: 2026年7月8日