첫 번째 Request 보내기
이 가이드는 FourA Dashboard를 사용하여 API key를 생성하고 첫 번째 request를 보내는 과정을 안내합니다.
Step 1: Dashboard 열기
Dashboard로 이동하여 FourA 계정으로 로그인합니다.
Step 2: API Key 생성하기
API Keys 페이지로 이동하여 Create Key를 클릭합니다.
키에 설명이 포함된 이름(예: "production-scraper" 또는 "dev-testing")을 지정합니다. 전체 키는 한 번만 표시되므로 즉시 복사해 두십시오.
키는 다음과 같은 형태입니다: pk_live_a1b2c3d4e5f6...
Step 3: Endpoint 선택하기
FourA는 다양한 시나리오를 위해 세 가지 endpoint를 제공합니다:
Single (POST /api/single/)
빠른 HTTP request를 보냅니다. 정적 HTML 페이지 및 API endpoint에 가장 적합합니다. response 시간: 일반적으로 2초 미만.
Browser (POST /api/browser/)
JavaScript를 렌더링하기 위해 Chrome 브라우저 인스턴스를 실행합니다. SPA, 지연 로드(lazy-loaded) 콘텐츠 및 JS 실행이 필요한 페이지에 가장 적합합니다. response 시간: 2초에서 10초.
Proxy (POST /api/proxy/)
자동 재시도 기능이 있는 순환 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": [["content-type", "text/html"]],
"data": "<html>...</html>",
"total_time": 0.45
}
주요 필드:
- status: 대상 사이트의 HTTP status 코드
- 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}'
browser response는 data 대신 body를 사용합니다:
{
"status": 200,
"headers": {"content-type": "text/html"},
"body": "<html>...</html>"
}
Common Issues
| 문제 | 해결 방법 |
|---|---|
| 빈 콘텐츠 | single에서 browser endpoint로 전환하십시오. 페이지에 JS 렌더링이 필요할 수 있습니다 |
| response에 Captcha 표시됨 | 자동 IP 순환을 위해 proxy endpoint로 전환하십시오 |
| 타임아웃 | timeout_ms를 늘리거나 URL이 올바른지 확인하십시오 |
Next Steps
- Dashboard Overview: 전체 Dashboard 가이드
- Playground: 코드를 작성하기 전에 Dashboard에서 request 테스트하기
- Choosing the Right Endpoint: 상세 비교
- Common Issues: 신속한 문제 해결