Task 생성

이 가이드는 API key를 생성하고 FourA Dashboard를 사용하여 첫 request를 보내는 방법을 설명합니다.

Step 1: Dashboard 열기

Dashboard로 이동하여 FourA 계정으로 로그인합니다.

Step 2: API Key 생성

API Keys 페이지로 이동하여 Create Key를 클릭합니다.

key에 설명이 포함된 이름(예: "production-scraper" 또는 "dev-testing")을 지정합니다. 확인 대화 상자에 복사 버튼과 함께 일반 텍스트 형태의 key가 표시됩니다.

이 단계를 놓친 경우, 나중에 key 행의 눈 모양 아이콘을 클릭하여 다시 확인할 수 있습니다. 표시 기능이 도입되기 전에 생성된 레거시 key는 다시 확인할 수 없으므로, 한 번 재생성하여 교체해야 합니다. 전체 흐름: API Key 관리.

key의 형태는 다음과 같습니다: pk_live_a1b2c3d4e5f6...

Step 3: Endpoint 선택

FourA는 다양한 시나리오를 위한 4개의 endpoint를 제공합니다:

Auto (`POST /api/auto/`)

스마트 기본값입니다. URL과 validate 규칙을 전달하면 FourA가 direct request, rotating proxy, 또는 전체 브라우저 중 작동하는 가장 저렴한 경로를 선택합니다. 새로운 사이트를 대상으로 하고 필요한 사항을 아직 모를 때 적합합니다.

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/`)

자동 재시도 기능이 포함된 rotating proxy를 통해 request를 라우팅합니다. 봇 탐지 또는 지역 제한 콘텐츠가 있는 사이트에 적합합니다.

Step 4: 첫 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: 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 본문(HTML, JSON, 또는 원시 텍스트)
total_time: request 소요 시간(초)

Step 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 endpoint로 시작합니다. 올바른 경로를 선택하고 작동한 방식을 기억합니다.
빈 콘텐츠	single에서 browser endpoint로 전환합니다. 페이지에 JS 렌더링이 필요할 가능성이 큽니다.
response에 Captcha 포함	자동 IP 로테이션을 위해 proxy endpoint로 전환합니다.
타임아웃	`timeout_ms`를 늘리거나 URL이 올바른지 확인합니다.
key 분실	API Keys에서 key 행의 눈 모양 아이콘을 클릭하여 확인하거나, 레거시 key인 경우 다시 생성합니다.

다음 단계

Dashboard 개요: Dashboard 전체 안내
Playground: 코드를 작성하기 전에 Dashboard에서 request 테스트
스마트 페치 (Auto): auto endpoint 심층 탐구
올바른 Endpoint 선택: 상세 비교
일반적인 문제: 문제의 빠른 해결

최근 업데이트: 2026년 7월 8일