# Task 생성

> URL: https://foura.ai/ko/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** 아래에 **Copy command**가 포함된 바로 실행 가능한 cURL 명령어가 제공됩니다. 모바일 기기나 태블릿에서는 **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/`)

스마트 기본값입니다. `validate` 규칙과 함께 URL을 전달하면 FourA가 회전 프록시부터 프록시 기반 전체 브라우저까지 단계적으로 시도하며, 통과하는 첫 번째 응답에서 중단합니다. `forceProxy: false`을 설정하면 직접 요청을 먼저 시도합니다. 대상 사이트의 요구 조건을 아직 모르는 새로운 사이트를 타겟팅할 때 가장 적합합니다.

### Single (`POST /api/single/`)

빠른 HTTP 요청을 전송합니다. 정적 HTML 페이지 및 API 엔드포인트에 가장 적합합니다. 응답 시간: 일반적으로 2초 미만.

### Browser (`POST /api/browser/`)

Chrome 브라우저 인스턴스를 실행하여 JavaScript를 렌더링합니다. SPA, 지연 로딩 콘텐츠 및 JS 실행이 필요한 페이지에 가장 적합합니다. 응답 시간: 2~10초.

### Proxy (`POST /api/proxy/`)

자동 재시도 기능을 통해 요청을 회전 프록시로 라우팅합니다. 요청자를 확인하거나 국가별로 다르게 응답하는 사이트에 가장 적합합니다.

## 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단계: 응답 확인

```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` 필드는 리다이렉트 홉당 하나의 객체로 구성된 배열입니다. 각 항목에는 상태 라인 및 대상 사이트가 반환한 모든 response header를 포함하는 `result`가 있습니다.

주요 필드:
- **status**: 대상 사이트의 HTTP 상태 코드
- **data**: response 본문(HTML, JSON 또는 원시 텍스트)
- **total_time**: request 소요 시간(초)

## 6단계: Browser Request 시도

대상 페이지가 JavaScript를 사용하여 콘텐츠를 렌더링하는 경우 브라우저 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 렌더링이 필요할 수 있습니다. |
| response에 인증 페이지가 표시됨 | 자동 IP 회전을 위해 proxy endpoint로 전환하세요 |
| Timeout | `timeout_ms` 값을 늘리거나 URL이 올바른지 확인하세요 |
| 키를 분실함 | **API Keys**에서 해당 키 행의 눈 아이콘을 클릭하여 확인하거나, 레거시 키인 경우 재발급하세요 |

## 다음 단계

- [Dashboard 개요](https://foura.ai/docs/dashboard/overview): 전체 대시보드 둘러보기
- [Playground](https://foura.ai/docs/dashboard/playground): 코드를 작성하기 전에 대시보드에서 request 테스트
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): auto endpoint 심층 가이드
- [적절한 Endpoint 선택](https://foura.ai/docs/guides/choosing-task-type): 상세 비교
- [자주 발생하는 문제](https://foura.ai/docs/troubleshooting/common-issues): 빠른 문제 해결
