# Ponowne użycie proxy w żądaniach

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

Dowiedz się, jak zachować ten sam węzeł wyjściowy proxy w kolejnych żądaniach, aby renderowanie JavaScriptu, wywołania API i pobieranie stron paginacji wychodziły z tego samego IP.

## Dlaczego warto ponownie używać proxy

Gdy po raz pierwszy odpytujesz cel, FourA wybiera dla Ciebie działające proxy. Odpowiedź z Proxy lub Auto zawiera użyte proxy ID. Przekaż to ID w kolejnych żądaniach, a:

- Kolejne strony trafią przez to samo wyjście, więc pliki cookie sesji i limity zapytań pozostaną spójne z perspektywy celu.
- Pobieranie ograniczone do danego kraju pozostaje w ramach Twojej listy dozwolonych bez ponownego wyboru.
- Tani endpoint `POST /api/single/` ponawia żądanie przez proxy, za którego wykrycie już zapłacono, w cenie Single zamiast Proxy.

Proxy ID to nieprzezroczysty ciąg base36 (np. `A1B2C3`). Nigdy nie jest to surowy adres IP.

## Gdzie znajduje się ID w odpowiedzi

| Endpoint | Pole | Kiedy występuje |
|----------|-------|-------------------|
| `POST /api/auto/` | `session.proxy` | Gdy `returnSession` to `true` (wartość domyślna) |
| `POST /api/single/` | `proxy` (główny poziom) | Tylko wtedy, gdy żądanie zawierało pole `proxy` |
| `POST /api/proxy/` | `proxy` (główny poziom) | Zawsze, w przypadku sukcesu |
| `POST /api/browser/` | `proxy` (główny poziom) | Tylko wtedy, gdy żądanie zawierało pole `proxy` |

Aby pobrać nowy węzeł wyjściowy bez przypinania go, zacznij od Auto lub Proxy. Oba wykrywają działające wyjście i zwracają jego ID.

## Wzorzec 1: Auto wykrywa, Single odtwarza

Najlepsze rozwiązanie, gdy masz cel, którego jeszcze nie znasz. Auto przechodzi całą sekwencję raz, a następnie Single ponownie używa zwycięskiej sesji dla każdej kolejnej strony.

```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"])
```

Odczytaj sesję za pomocą `.get()`. Sesja uzyskana przez zwykłe pobranie proxy ma `proxy` i nie ma `userAgent`, a niektóre odpowiedzi nie zawierają `session` wcale.

Wywołanie Auto kosztuje tyle, ile zużyje jego drabina. Każde kolejne wywołanie Single kosztuje 2 kredyty (Single z `unblocker`, wartość domyślna).

## Wzorzec 2: Proxy wykrywa, Browser renderuje przez to samo wyjście

Użyj tego, gdy cel musi widzieć konkretny kraj wyjściowy, a ostateczna treść wymaga JavaScriptu.

```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
  }'
```

Nie wywołuj ponownie `/api/proxy/`, aby odświeżyć wybór. Nowe wywołanie może wybrać inny węzeł wyjściowy i zniweczyć cel przypięcia. Jeśli przypięty węzeł wyjściowy przestanie działać, wykonaj nowe wywołanie `/api/proxy/`, aby wybrać nowy, a następnie kontynuuj z nim pracę.

## Wzorzec 3: Pomijanie spalonego węzła wyjściowego

Jeśli działający wcześniej węzeł wyjściowy zacznie zwracać odmowy lub strony weryfikacji, poinstruuj FourA, aby unikać go przy następnym wyborze.

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

`ignoreProxies` przyjmuje listę identyfikatorów proxy z wcześniejszych odpowiedzi. Działa w `/api/proxy/` oraz `/api/auto/`. Lista jest uwzględniana przy każdym wewnętrznym ponowieniu, więc pojedyncze wywołanie z `ignoreProxies` nigdy nie wybierze spalonych węzłów wyjściowych.

## Jak długo przypięta sesja pozostaje aktywna

Sam węzeł wyjściowy działa tak długo, jak długo bazowe proxy jest sprawne, zazwyczaj od minut do godzin. Jeśli ponowne wywołanie zaczyna zwracać testy CAPTCHA, blokady lub nieoczekiwane przekierowania, węzeł wyjściowy został prawdopodobnie zrotowany albo cel odświeżył uprawnienia dostępu.

W takiej sytuacji masz dwie opcje:

1. Nowe wywołanie `/api/auto/` dla tego samego URL. Tryb Auto znajdzie nową działającą sesję; odrzuć poprzednie identyfikatory.
2. Nowe wywołanie `/api/proxy/` z `ignoreProxies: ["<burned-id>"]`, jeśli chcesz nadal przypinać sesję ręcznie.

Pliki cookie sesji z odpowiedzi Auto wygasają również zgodnie z harmonogramem samego celu. Niektóre witryny utrzymują autoryzację przez wiele godzin, inne przez kilka minut. Traktuj sesję jak pamięć podręczną, a nie trwały token.

## Kiedy identyfikator nie chce się przypiąć

Dla wartości `proxy` mogą zostać zwrócone trzy różne błędy 400, a każdy z nich oznacza co innego:

| Błąd | Co się stało | Co zrobić |
|-------|---------------|------------|
| `Invalid proxy format` | Wartość nie jest identyfikatorem wystawionym przez FourA. Wpisanie surowego adresu proxy prowadzi tutaj. | Przekaż nieprzetworzony ciąg znaków z odpowiedzi, dosłownie. |
| `Proxy not found` | Identyfikator został zdekodowany, ale nie wskazuje już na aktywny węzeł wyjściowy. | Pobierz nowy węzeł wyjściowy z nowego wywołania Auto lub Proxy. |
| `Managed exit: this proxy id cannot be pinned to a request` | Identyfikator jest węzłem premium, a limit transferu premium w twoim planie na ten okres został wyczerpany lub twój plan nie obejmuje węzłów premium. | Wykonaj wywołanie przez `POST /api/proxy/` i użyj węzła, który zostanie wybrany, albo dokup transfer premium i przypnij go ponownie. |

Trzeci błąd może pojawić się dla identyfikatora, który został zwrócony przez udane wywołanie, więc możesz na niego trafić bez popełnienia żadnego błędu. Potraktuj go tak samo, jak wygasłą sesję: wróć do nowego wywołania wyszukującego zamiast ponawiać ten sam identyfikator.

## Częste błędy

- **Ponowne używanie ID proxy między kontami.** Nie udostępniaj identyfikatorów między kontami: ID, które jedno konto może przypiąć, może zostać odrzucone dla innego, na przykład węzeł wyjściowy premium w planie bez ruchu premium.
- **Próby dekodowania ID.** Ciąg base36 jest nieprzejrzysty. Nie parsuj go, nie usuwaj znaków ani nie zmieniaj wielkości liter na małe. Przekazuj go dokładnie w niezmienionej formie.
- **Przypinanie przez węzeł wyjściowy objęty rate limitem.** Jeśli cel nakłada rate limit na adres IP, kierowanie wielu żądań przez jeden węzeł wyjściowy szybciej wywoła blokady. W przypadku obciążeń o dużym wolumenie pozwól Auto lub Proxy rotować przez wiele węzłów i przypinaj tylko wtedy, gdy cel rzeczywiście tego wymaga.
- **Przypadkowe przypięcie węzła wyjściowego premium.** ID z wywołania obsłużonego przez węzeł premium (`exitClass: "premium"` w Proxy lub Auto) przypina węzeł premium. ID z wywołania premium w Auto przypina węzeł premium w Single lub Browser, ale niekoniecznie ten sam adres, którego użyło Auto. Każde powtórzenie żądania z jego użyciem pomniejsza dostępny pakiet ruchu premium, a odpowiedź zawiera `X-FourA-Exit-Class: premium`.
- **Wysyłanie `exitCountries` w planie bez targetowania geograficznego.** Dobór kraju jest dostępny od planu Startup wzwyż. W planie bez tej funkcji wywołanie z parametrem `exitCountries` jest odrzucane z błędem `403` oraz `X-FourA-Limit: plan_limit_feature`.
- **Ignorowanie `exitCountries` w kolejnym żądaniu.** Jeśli przypniesz węzeł wyjściowy z określonym zakresem, a następnie wywołasz Proxy ponownie bez `exitCountries`, kolejne żądanie może przejść przez inny kraj. Przekazuj zakres przy każdym wywołaniu, które go wymaga.

## Powiązane

- [API Endpoints](https://foura.ai/docs/api/endpoints): Pełna dokumentacja parametrów i odpowiedzi
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Jak Auto tworzy odtwarzaną sesję
- [Protected sites](https://foura.ai/docs/guides/protected-sites): Kiedy przypinanie pomaga, a kiedy lepsza jest rotacja
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues): `no_eligible_proxy` i inne błędy proxy
- [Why a Proxy Request Ran Out of Tries](https://foura.ai/docs/troubleshooting/proxy-attempt-report): Odczytywanie `attemptReport`, gdy wywołanie Proxy podda próbę
