Ponowne użycie proxy w żądaniach
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.
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.
# 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.
{
"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:
- Nowe wywołanie
/api/auto/dla tego samego URL. Tryb Auto znajdzie nową działającą sesję; odrzuć poprzednie identyfikatory. - Nowe wywołanie
/api/proxy/zignoreProxies: ["<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ź zawieraX-FourA-Exit-Class: premium. - Wysyłanie
exitCountriesw planie bez targetowania geograficznego. Dobór kraju jest dostępny od planu Startup wzwyż. W planie bez tej funkcji wywołanie z parametremexitCountriesjest odrzucane z błędem403orazX-FourA-Limit: plan_limit_feature. - Ignorowanie
exitCountriesw kolejnym żądaniu. Jeśli przypniesz węzeł wyjściowy z określonym zakresem, a następnie wywołasz Proxy ponownie bezexitCountries, kolejne żądanie może przejść przez inny kraj. Przekazuj zakres przy każdym wywołaniu, które go wymaga.
Powiązane
- API Endpoints: Pełna dokumentacja parametrów i odpowiedzi
- Smart Fetch (Auto): Jak Auto tworzy odtwarzaną sesję
- Protected sites: Kiedy przypinanie pomaga, a kiedy lepsza jest rotacja
- Common Issues:
no_eligible_proxyi inne błędy proxy - Why a Proxy Request Ran Out of Tries: Odczytywanie
attemptReport, gdy wywołanie Proxy podda próbę