> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utage-system.com/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

> 5分で最初のファネルを作成する

このガイドでは、APIを使ってファネル・ステップ・ページを作成し、公開URLを確認するまでの流れを説明します。

## 1. APIキーを取得

まず[認証](/authentication)の手順に従ってAPIキーを取得してください。

以降の例では `YOUR_API_KEY` をお手持ちのAPIキーに置き換えてください。

## 2. ファネルを作成

```bash theme={null}
curl -X POST "https://api.utage-system.com/v1/funnels" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "はじめてのファネル"
  }'
```

```json レスポンス theme={null}
{
    "data": {
        "id": "fn_abc123",
        "name": "はじめてのファネル"
    }
}
```

レスポンスの `id` を次のステップで使います。

## 3. ステップを作成

ファネルの中にステップを作成します。ステップはページをグループ化する単位です。

```bash theme={null}
curl -X POST "https://api.utage-system.com/v1/funnels/fn_abc123/steps" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "メインページ"
  }'
```

```json レスポンス theme={null}
{
    "data": {
        "id": "st_def456",
        "name": "メインページ",
        "order": 1
    }
}
```

## 4. ページを作成

ステップの中にページを作成します。要素は `section > row > col > コンテンツ要素` の階層構造で指定します。

```bash theme={null}
curl -X POST "https://api.utage-system.com/v1/funnels/fn_abc123/steps/st_def456/pages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "LPページ",
    "pc_width": 800,
    "elements": [
      {
        "type": "section",
        "children": [
          {
            "type": "row",
            "children": [
              {
                "type": "col",
                "children": [
                  {
                    "type": "text",
                    "content": "<p>はじめてのページです</p>"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }'
```

```json レスポンス theme={null}
{
    "data": {
        "id": "pg_ghi789",
        "title": "LPページ",
        "content_type": "elements",
        "pc_width": 800,
        "step_url": "https://utage-system.com/p/xxxxx/",
        "page_url": "https://utage-system.com/page/pg_ghi789"
    }
}
```

<Note>
  要素構造の詳細は[要素タイプリファレンス](/api-reference/funnel/element-types)を参照してください。
</Note>

## 5. 公開URLを確認

作成したページの公開URLはレスポンスの `step_url` で確認できます。ステップ一覧APIからも取得できます。

```bash theme={null}
curl -X GET "https://api.utage-system.com/v1/funnels/fn_abc123/steps" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

```json レスポンス theme={null}
{
    "data": [
        {
            "id": "st_def456",
            "name": "メインページ",
            "step_url": "https://utage-system.com/p/xxxxx/",
            "order": 1
        }
    ]
}
```

`step_url` にアクセスすると、作成したページが表示されます。

## 次のステップ

<CardGroup cols={2}>
  <Card title="LP作成ガイド" icon="palette" href="/guides/create-lp">
    画像やボタンを含むLPの作成方法
  </Card>

  <Card title="APIリファレンス" icon="book" href="/api-reference/overview">
    全エンドポイントの詳細仕様
  </Card>
</CardGroup>