문서 › Dashboard › Task 생성

Task 생성

이 가이드는 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단계: Endpoint 선택

FourA는 다양한 시나리오에 맞춘 네 가지 endpoint를 제공합니다.

Auto (POST /api/auto/)

지능형 기본 옵션입니다. URL과 validate 규칙을 전달하면 FourA가 직접 요청, rotating proxy, 전체 브라우저 중 정상 작동하는 가장 경제적인 방식을 자동으로 선택합니다. 새 사이트를 대상으로 작업하여 어떤 방식이 필요한지 아직 모를 때 가장 적합합니다.

Single (POST /api/single/)

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

Browser (POST /api/browser/)

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

Proxy (POST /api/proxy/)

자동 재시도 기능과 함께 rotating proxy를 통해 요청을 라우팅합니다. 요청자의 신원을 확인하거나 국가별로 다른 응답을 반환하는 사이트에 가장 적합합니다.

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

주요 필드:

  • status: 대상 사이트의 HTTP 상태 코드
  • data: response body (HTML, JSON 또는 원시 텍스트)
  • total_time: request 소요 시간 (초 단위)

6단계: 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}'

브라우저 response는 data 대신 body을 사용합니다.

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

자주 발생하는 문제

문제 해결 방법
어떤 엔진을 사용할지 모르는 경우 auto 엔드포인트부터 시작하세요. 올바른 경로를 선택하고 정상 작동했던 방식을 기억합니다.
빈 콘텐츠 single에서 browser 엔드포인트로 전환하세요: 페이지에 JS 렌더링이 필요할 수 있습니다
응답에 인증 페이지가 나타남 자동 IP 순환을 위해 proxy 엔드포인트로 전환하세요
타임아웃 timeout_ms 값을 늘리거나 URL이 올바른지 확인하세요
키를 분실한 경우 API Keys의 키 행에서 눈 아이콘을 클릭하여 확인하거나, 레거시 키인 경우 재생성하세요

다음 단계

최근 업데이트: 2026년 9월 30일
← 대시보드 개요 API Key 관리 →