여러 요청에서 동일한 Proxy 재사용

후속 request 전반에서 동일한 proxy 출구를 유지하여 JavaScript 렌더링, API 호출, 페이지네이션 조회가 모두 동일한 IP에서 발생하도록 설정하는 방법을 알아봅니다.

Proxy를 재사용하는 이유

대상 사이트에 처음 연결할 때 FourA가 작동하는 proxy를 자동으로 선택합니다. Proxy 또는 Auto response에는 사용된 proxy ID가 포함됩니다. 후속 request에 해당 ID를 다시 전달하면 다음과 같은 이점이 있습니다.

  • 후속 페이지가 동일한 출구를 통해 전달되므로 세션 cookie 및 rate limit이 대상 사이트에서 일관되게 유지됩니다.
  • 국가 범위 조회가 새 선택 없이도 허용 목록 내에서 유지됩니다.
  • 비용이 저렴한 POST /api/single/ endpoint가 이미 탐색 비용을 지불한 proxy를 통해 재생되며, Proxy 비용 대신 Single 비용이 적용됩니다.

proxy ID는 불투명한 base36 문자열(예: A1B2C3)이며, 원시 IP가 아닙니다.

Response 내 ID 위치

Endpoint Field 표시 시점
POST /api/auto/ session.proxy returnSession가 true인 경우 (기본값)
POST /api/single/ proxy (최상위) request에 proxy 필드가 제공된 경우에만
POST /api/proxy/ proxy (최상위) 항상, 성공 시
POST /api/browser/ proxy (최상위) request에 proxy 필드가 제공된 경우에만

고정하지 않고 새로운 출구를 얻으려면 Auto 또는 Proxy로 시작하십시오. 두 방식 모두 작동하는 출구를 탐색하고 해당 ID를 반환합니다.

패턴 1: Auto 탐색, Single 재생

아직 파악되지 않은 대상을 처리할 때 가장 적합합니다. Auto가 계층 구조를 한 번 탐색한 후, Single이 모든 후속 페이지에 성공한 세션을 재사용합니다.

import requests

API = "https://eu.api.foura.ai"
H = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}

# Step 1: discover a working exit with Auto.
r = requests.post(f"{API}/api/auto/", headers=H, json={
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
}).json()

session = r.get("session") or {}
proxy = session.get("proxy")
user_agent = session.get("userAgent")

# Step 2: paginate with Single, reusing the same exit, User-Agent and cookies.
for sku in ("43", "44", "45"):
    body = {"method": "GET", "url": f"https://example.com/product/{sku}"}
    if proxy:
        body["proxy"] = proxy
    headers = []
    if user_agent:
        headers.append(["User-Agent", user_agent])
    if session.get("cookies"):
        headers.append(["Cookie", "; ".join(f"{c['name']}={c['value']}" for c in session["cookies"])])
    if headers:
        body["headers"] = headers
    p = requests.post(f"{API}/api/single/", headers=H, json=body).json()
    print(sku, p["status"])

.get()(으)로 세션을 읽습니다. 일반 proxy 가져오기로 획득한 세션에는 proxy이(가) 있으며 userAgent은(는) 없고, 일부 응답에는 session이(가) 전혀 포함되지 않습니다.

Auto 호출 비용은 해당 래더에서 소비되는 만큼 청구됩니다. 모든 후속 Single 호출에는 2크레딧이 소요됩니다(기본값인 unblocker 적용 Single).

패턴 2: Proxy가 탐색하고 동일한 출구를 통해 Browser가 렌더링

대상이 특정 출구 국가를 인식해야 하고 최종 콘텐츠에 JavaScript가 필요한 경우에 사용합니다.

# Step 1: pick a country-scoped exit with 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,
    "exitCountries": ["FR", "GB"],
    "request": {"method": "GET", "url": "https://example.com/pricing"}
  }'
# Response includes: "proxy": "A1B2C3", "exitCountry": "FR"

# Step 2: render the JS-heavy page through THAT exit.
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/pricing",
    "proxy": "A1B2C3",
    "timeout_ms": 20000
  }'

선택 항목을 새로고침하기 위해 /api/proxy/을(를) 다시 호출하지 마십시오. 새로운 호출은 다른 exit을 선택할 수 있어 고정(pinning)의 목적에 어긋납니다. 고정된 exit의 작동이 중단되면 새로운 /api/proxy/ 호출을 실행하여 새 항목을 선택한 후 이를 계속 사용하십시오.

패턴 3: 차단된 exit 건너뛰기

정상적으로 작동하던 exit이 거부 응답이나 인증 페이지를 반환하기 시작하면 FourA가 다음 선택 시 해당 exit을 제외하도록 지정하십시오.

{
  "maxTries": 5,
  "ignoreProxies": ["A1B2C3"],
  "request": { "method": "GET", "url": "https://example.com/data" }
}

ignoreProxies는 이전 응답에서 받은 proxy ID 목록을 허용합니다. /api/proxy/ 및 /api/auto/에서 작동합니다. 이 목록은 모든 내부 재시도 시 준수되므로 ignoreProxies를 사용한 단일 호출은 소진된 exit를 절대 선택하지 않습니다.

고정된 세션의 유효 기간

exit 자체는 기본 proxy가 정상 상태를 유지하는 동안 지속되며, 일반적으로 수 분에서 수 시간 정도입니다. 재전송 시 챌린지, 차단 또는 예기치 않은 리디렉션이 반환되기 시작하면 exit가 교체되었거나 대상 사이트에서 clearance를 갱신했을 가능성이 높습니다.

이러한 상황에서는 두 가지 옵션이 있습니다:

  1. 동일한 URL에 대해 새로운 /api/auto/ 호출을 수행합니다. Auto가 작동하는 새 세션을 탐색하므로 이전 ID는 버리십시오.
  2. 수동 고정을 계속 유지하려면 ignoreProxies: ["<burned-id>"]를 사용하여 새로운 /api/proxy/ 호출을 수행합니다.

Auto 응답의 세션 cookie 역시 대상 사이트 자체의 일정에 따라 만료됩니다. 어떤 사이트는 몇 시간 동안 clearance를 유지하지만, 어떤 사이트는 몇 분 동안만 유지합니다. 세션을 영구적인 token이 아닌 캐시로 취급하십시오.

ID가 고정되지 않는 경우

proxy 값에서 세 가지 유형의 400 에러가 반환될 수 있으며, 각각 다른 의미를 가집니다:

오류 발생 원인 해결 방법
Invalid proxy format FourA가 발급한 ID가 아닌 값입니다. 원시 proxy 주소를 입력하면 여기에 해당합니다. 응답에서 받은 불투명 문자열을 그대로 전송하십시오.
Proxy not found ID 디코딩에는 성공했으나, 더 이상 유효한 exit로 확인되지 않습니다. 새로운 Auto 또는 Proxy 호출을 통해 최신 exit를 가져오십시오.
Managed exit: this proxy id cannot be pinned to a request 해당 ID는 프리미엄 exit이며, 이번 기간의 플랜 프리미엄 트래픽을 모두 소진했거나 플랜에 프리미엄 exit가 포함되어 있지 않습니다. POST /api/proxy/를 통해 호출을 실행하여 선택된 exit를 사용하거나, 프리미엄 트래픽을 추가한 후 다시 고정하십시오.

세 번째 오류는 성공적인 호출에서 전달된 ID에서도 반환될 수 있으므로, 아무런 잘못을 하지 않았더라도 발생할 수 있습니다. 만료된 세션을 처리하듯 동일한 ID를 재시도하는 대신 새로운 탐색 호출로 fallback하십시오.

자주 발생하는 실수

  • 계정 간 proxy ID 재사용. 계정 간에 ID를 공유하지 마십시오. 특정 계정에서 고정 가능한 ID라도 다른 계정에서는 거부될 수 있습니다(예: 프리미엄 트래픽이 포함되지 않은 플랜에서의 프리미엄 출구).
  • ID 디코딩 시도. base36 문자열은 불투명(opaque)합니다. 파싱하거나, 문자를 제거하거나, 소문자로 변환하지 마십시오. 그대로 다시 전달하십시오.
  • rate limit이 적용된 출구를 통한 고정. 대상이 IP별로 rate limit을 적용하는 경우 단일 출구로 많은 request를 집중시키면 차단이 더 빨리 발생합니다. 대용량 워크로드의 경우 Auto 또는 Proxy가 여러 출구를 순환하도록 두고, 대상에서 실제로 필요한 경우에만 고정하십시오.
  • 의도치 않은 프리미엄 출구 고정. 프리미엄 출구가 처리한 호출(Proxy 또는 Auto의 exitClass: "premium")에서 생성된 ID는 프리미엄 출구를 고정합니다. 프리미엄 Auto 호출에서 생성된 ID는 Single 또는 Browser에서 프리미엄 출구를 고정하지만, Auto가 사용한 주소와 반드시 일치하지는 않습니다. 이를 통한 모든 재생(replay)은 프리미엄 트래픽으로 계산되며, response에는 X-FourA-Exit-Class: premium가 포함됩니다.
  • 지리적 타겟팅이 없는 플랜에서 exitCountries 전송. 국가 타겟팅(scope)은 Startup 플랜 이상부터 포함됩니다. 지원되지 않는 플랜에서 exitCountries를 전송하는 호출은 403 및 X-FourA-Limit: plan_limit_feature와 함께 거부됩니다.
  • 후속 호출에서 exitCountries 누락. scope가 지정된 출구를 고정한 후 exitCountries 없이 Proxy를 다시 호출하면, 후속 요청이 다른 국가를 통해 전송될 수 있습니다. 필요한 모든 호출에 scope를 유지하십시오.
최근 업데이트: 2026년 11월 5일