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

> URL: https://foura.ai/ko/docs/how-to/reuse-a-proxy
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

후속 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이 모든 후속 페이지에 성공한 세션을 재사용합니다.

```python
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가 필요한 경우에 사용합니다.

```bash
# 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을 제외하도록 지정하십시오.

```json
{
  "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를 유지하십시오.

## 관련 문서

- [API Endpoints](https://foura.ai/docs/api/endpoints): 전체 파라미터 및 response 레퍼런스
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Auto가 재생할 세션을 생성하는 방식
- [Protected sites](https://foura.ai/docs/guides/protected-sites): 고정이 유용한 경우와 순환이 더 유리한 경우
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues): `no_eligible_proxy` 및 기타 proxy 오류
- [Why a Proxy Request Ran Out of Tries](https://foura.ai/docs/troubleshooting/proxy-attempt-report): Proxy 호출이 중단될 때 `attemptReport` 확인 방법
