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 아래에 Copy command가 포함된 바로 실행 가능한 cURL 명령어가 제공됩니다. 모바일 기기나 태블릿에서는 Try it in the Playground를 통해 해당 페이지로 이동할 수 있습니다.
키를 확인하지 못했다면 나중에 키 행의 눈 모양 아이콘을 클릭하여 다시 확인할 수 있습니다. 키 확인 기능 도입 이전에 생성된 기존 키는 다시 표시할 수 없으므로, 전환하려면 새로 다시 생성해야 합니다. 전체 프로세스: Managing 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단계: 첫 번째 요청 전송
터미널을 열고 다음을 실행합니다:
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단계: 응답 확인
{
"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를 대신 사용하십시오.
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에 인증 페이지가 표시됨 | 자동 IP 회전을 위해 proxy endpoint로 전환하세요 |
| Timeout | timeout_ms 값을 늘리거나 URL이 올바른지 확인하세요 |
| 키를 분실함 | API Keys에서 해당 키 행의 눈 아이콘을 클릭하여 확인하거나, 레거시 키인 경우 재발급하세요 |
다음 단계
- Dashboard 개요: 전체 대시보드 둘러보기
- Playground: 코드를 작성하기 전에 대시보드에서 request 테스트
- Smart Fetch (Auto): auto endpoint 심층 가이드
- 적절한 Endpoint 선택: 상세 비교
- 자주 발생하는 문제: 빠른 문제 해결