문서 › 가이드 › 올바른 엔드포인트 선택하기

올바른 엔드포인트 선택하기

FourA는 서로 다른 시나리오에 최적화된 네 가지 요청 엔드포인트를 제공합니다. 올바른 엔드포인트를 선택하면 시간을 절약하고, 비용을 줄이며, 성공률을 높일 수 있습니다.

빠른 결정 가이드

다음에 해당하면 auto 엔드포인트를 사용하세요.

  • 새로운 사이트를 대상으로 하고 무엇이 필요한지 아직 모를 때
  • 직접 요청, proxy 회전, 브라우저 대체를 한 번의 호출로 처리하고 싶을 때
  • 동일한 호스트에 대한 다음 호출에서 저렴하게 다시 재생할 수 있는 세션을 원할 때

다음에 해당하면 single 엔드포인트를 사용하세요.

  • 페이지가 서버에서 렌더링될 때 (JavaScript 불필요)
  • 최대 속도(일반적으로 1초 미만)가 필요할 때
  • 이미 작동하는 것으로 알려진 호스트의 API나 정적 HTML 페이지에 요청할 때

다음에 해당하면 browser 엔드포인트를 사용하세요.

  • 페이지 콘텐츠 렌더링에 JavaScript가 필요할 때
  • 초기 페이지 로드 후 콘텐츠가 로드될 때
  • 완전히 렌더링된 DOM이 필요할 때

다음에 해당하면 proxy 엔드포인트를 사용하세요.

  • 대상 사이트가 적극적으로 요청을 차단할 때
  • 여러 IP 주소를 순환해야 할 때
  • 이전 시도에서 403 또는 captcha 페이지를 반환했을 때

엔드포인트 비교

Auto (POST /api/auto/)

스마트 가져오기 엔드포인트입니다. URL과 (이상적으로는) validate 규칙을 전달하면 FourA는 비용을 고려한 단계를 거칩니다: 저렴한 직접 탐색, 회전하는 proxy, 전체 브라우저. validate과 일치하는 응답을 반환하는 첫 번째 단계가 선택됩니다. 동일한 호스트에 대한 반복 호출 시 준비된 세션이 다시 재생되므로 두 번째 호출은 저렴합니다.

curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'

일반적인 응답 시간: 200ms(준비됨)에서 30초 이상(까다로운 사이트에서의 콜드 솔브) 최적의 사용처: 새로운 대상, 혼합 보호 사이트, "그냥 페이지만 줘"

더 자세한 단계별 설명은 스마트 가져오기 가이드를 참조하세요.

Single (POST /api/single/)

가장 빠른 옵션입니다. 브라우저 프로세스를 실행하지 않고 실제 브라우저와 유사한 와이어 특성을 가진 HTTP 요청을 보냅니다.

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/api/products"}'

일반적인 응답 시간: 200ms에서 2s 최적의 사용처: API, 뉴스 사이트, 블로그, 정적 제품 페이지

Browser (POST /api/browser/)

Chrome 브라우저 인스턴스에서 URL을 엽니다. 페이지가 완전히 로드되고 JavaScript가 실행되며 최종 렌더링된 HTML을 얻을 수 있습니다.

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/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'

일반적인 응답 시간: 2s에서 10s 최적의 사용처: 단일 페이지 앱(SPA), 지연 로딩이 있는 사이트, JavaScript로 렌더링된 콘텐츠

Proxy (POST /api/proxy/)

HTTP 요청과 자동 proxy 회전을 결합합니다. 첫 번째 시도가 실패하거나 차단되면 FourA는 다른 proxy를 통해 재시도합니다.

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing"
    }
  }'

일반적인 응답 시간: 1s에서 5s 최적의 사용처: 전자상거래 가격 모니터링, 여행 정보 집계, 봇 감지가 있는 사이트

Auto vs Manual

언제 auto를 선택하고 언제 Single, Proxy 또는 Browser를 직접 호출해야 할까요?

auto 선택 manual 선택
사이트에 무엇이 필요한지 아직 모를 때 대상이 원하는 엔진을 정확히 알 때
알아서 작동하는 한 번의 호출을 원할 때 알려진 대상을 위해 요청 형태를 최적화할 때
auto가 학습한 세션을 재사용하는 것이 괜찮을 때 호출당 재시도, 시간 초과, proxy 선택을 완전히 제어하고 싶을 때
첫 번째 호출에서 몇 초간의 탐색 비용을 지불할 의향이 있을 때 첫 번째 호출의 대기 시간이 탐색보다 중요할 때

Auto가 항상 저렴한 선택은 아닙니다. 이미 대상이 Single 및 unblocker를 켠 상태에서 작동한다는 것을 알고 있다면 Single을 직접 호출하는 것이 탐색을 건너뛰고 2크레딧의 비용이 듭니다. 동일한 대상에 대한 Auto는 단계에서 소비하는 모든 비용이 듭니다.

접근 방식을 결합해야 하는 경우

일부 워크플로우는 여러 엔드포인트를 사용하는 것이 유리합니다.

  1. auto로 발견: validate 규칙을 전달하고 단계가 사이트에 어떤 단계가 필요한지 파악하게 합니다.
  2. single로 재생: auto가 반환한 session.proxy, session.cookies, session.userAgent를 가져와 동일한 호스트의 후속 페이지에 대해 Single을 호출합니다.
  3. browser로 대체: single이 실패하기 시작하면 browser 렌더링으로 전환합니다.
  4. proxy 추가: auto 없이 차단(403 / captcha)을 당하는 경우 자동 회전을 위해 proxy 엔드포인트로 요청을 래핑합니다.

이러한 점진적인 접근 방식은 비용을 낮게 유지하면서 성공률을 높게 유지합니다.

성능 팁

  • 보호된 대상에 validate.data.accept 하위 문자열을 전달하세요. 이것이 없으면 auto는 실제 페이지와 챌린지 중간 페이지를 구별할 수 없습니다.
  • 이미 작동하는 것으로 알려진 호스트에 대해서는 기본적으로 single 엔드포인트를 사용하고 필요할 때만 업그레이드하세요.
  • 불필요한 콘텐츠를 기다리지 않으려면 browser 요청에서 checkText를 설정하세요.
  • 재시도 동작을 제어하려면 proxy 요청에서 maxTries를 설정하세요 (기본값은 5, 최대값은 90).
  • timeout_ms를 적절하게 유지하세요: 대부분의 페이지는 10에서 15초, 보호된 사이트에 대한 콜드 auto 실행은 30초 이상입니다.

다음 단계

최근 업데이트: 2026년 6월 30일
안티 봇 방어 처리 →