# タスクの作成

> URL: https://foura.ai/ja/docs/dashboard/creating-a-task
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

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

## ステップ 1: Dashboard を開く

[Dashboard](https://foura.ai/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](https://foura.ai/docs/dashboard/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: 最初のリクエストを送信する

ターミナルを開き、以下を実行します:

```bash
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 の確認

```json
{
  "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 を使用します:

```bash
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` が使用されます:

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

## よくある問題

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

## 次のステップ

- [ダッシュボードの概要](https://foura.ai/docs/dashboard/overview): ダッシュボード全体の詳細ガイド
- [Playground](https://foura.ai/docs/dashboard/playground): コードを書く前にダッシュボードでリクエストをテスト
- [スマートフェッチ (Auto)](https://foura.ai/docs/guides/smart-fetch): auto endpoint の詳細解説
- [適切なエンドポイントの選択](https://foura.ai/docs/guides/choosing-task-type): 詳細な比較
- [よくある問題](https://foura.ai/docs/troubleshooting/common-issues): 問題を迅速に解決
