タスクの作成
このガイドでは、FourA Dashboard を使用して API キーを作成し、最初のリクエストを送信する手順を説明します。
ステップ 1: Dashboard を開く
Dashboard にアクセスし、FourA アカウントでサインインします。
ステップ 2: API キーを作成する
API Keys ページに移動し、Create API key をクリックします。キーを作成した後は、リストの上のボタンが Create Key に変わります。
キーにわかりやすい名前(例: "production-scraper"、"dev-testing")を付けます。API Key Created ダイアログに平文のキーとコピー用ボタンが表示され、Test your first request の下には実行可能な cURL コマンドと Copy command が表示されます。スマートフォンやタブレットでは、代わりに Try it in the Playground からアクセスできます。
見逃した場合は、後からキーの行にある目のアイコンをクリックして再表示できます。表示機能がリリースされる前に作成されたレガシーキーは再表示できません。移行するには一度再生成してください。詳細な手順: Managing API Keys。
キーの形式は次のようになります: pk_live_a1b2c3d4e5f6...
ステップ 3: エンドポイントを選択する
FourA には、さまざまなシナリオに対応する 4 つのエンドポイントがあります:
Auto (POST /api/auto/)
スマートなデフォルト設定です。URL を渡し(validate ルールと組み合わせるのが理想的です)、FourA はローテーション proxy から proxy 経由のフルブラウザまで順次試行し、合格した最初の応答で停止します。最初にダイレクトな request を試行させるには forceProxy: false を設定します。新しいサイトを対象としており、必要な設定がまだ分からない場合に最適です。
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 経由で request をルーティングします。リクエスト元を検査するサイトや、国ごとに異なる応答を返すサイトに最適です。
ステップ 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: response の確認
{
"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 所要時間 (秒)
ステップ 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: コードを書く前にダッシュボードでリクエストをテスト
- スマートフェッチ (Auto): auto endpoint の詳細解説
- 適切なエンドポイントの選択: 詳細な比較
- よくある問題: 問題を迅速に解決