最初のrequestの送信
このガイドでは、FourA Dashboardを使用してAPIキーを作成し、最初のrequestを送信する手順を説明します。
Step 1: Open the Dashboard
Dashboardにアクセスし、FourAアカウントでサインインします。
Step 2: Create an API Key
API Keysページに移動し、Create Keyをクリックします。
キーに分かりやすい名前(例: "production-scraper" または "dev-testing")を付けます。完全なキーは一度しか表示されないため、すぐにコピーしてください。
キーは次のようになります: pk_live_a1b2c3d4e5f6...
Step 3: Choose an Endpoint
FourAには、さまざまなシナリオに対応する3つのendpointがあります:
Single (POST /api/single/)
高速なHTTP requestを送信します。静的なHTMLページやAPI endpointに最適です。response時間: 通常2秒未満。
Browser (POST /api/browser/)
Chromeブラウザのインスタンスを実行してJavaScriptをレンダリングします。SPA、遅延読み込みコンテンツ、JSの実行が必要なページに最適です。response時間: 2から10秒。
Proxy (POST /api/proxy/)
自動再試行機能付きのローテーションproxyを経由してrequestをルーティングします。ボット検出や地域制限のあるコンテンツを持つサイトに最適です。
Step 4: Send Your First Request
ターミナルを開き、以下を実行します:
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"}'
Step 5: Read the Response
{
"status": 200,
"headers": [["content-type", "text/html"]],
"data": "<html>...</html>",
"total_time": 0.45
}
主なフィールド:
- status: ターゲットサイトからのHTTPステータスコード
- data: responseボディ(HTML、JSON、または生のテキスト)
- total_time: 秒単位でのrequest所要時間
Step 6: Try a Browser Request
ターゲットページがコンテンツのレンダリングに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}'
browserのresponseでは、dataではなくbodyが使用されます:
{
"status": 200,
"headers": {"content-type": "text/html"},
"body": "<html>...</html>"
}
Common Issues
| 問題 | 解決策 |
|---|---|
| コンテンツが空 | singleからbrowser endpointに切り替えてください。ページがJSレンダリングを必要としている可能性があります |
| response内のCAPTCHA | 自動IPローテーションのためにproxy endpointに切り替えてください |
| タイムアウト | timeout_msを増やすか、URLが正しいか確認してください |
Next Steps
- Dashboardの概要: Dashboardの完全なウォークスルー
- Playground: コードを書く前にDashboardでrequestをテスト
- 適切なendpointの選択: 詳細な比較
- よくある問題: 問題を迅速に解決