Proxy für mehrere Requests wiederverwenden

Erfahre, wie du denselben Proxy-Exit über Folge-Requests hinweg beibehältst, damit JavaScript-Renderings, API-Aufrufe und paginierte Abrufe alle von derselben IP ausgehen.

Warum einen Proxy wiederverwenden

Wenn du ein Ziel zum ersten Mal anfragst, wählt FourA einen funktionierenden Proxy für dich aus. Eine Proxy- oder Auto-Response enthält die verwendete Proxy-ID. Übergib diese ID bei späteren Requests wieder und:

  • Folgeseiten laufen über denselben Exit, sodass Session-Cookies und Rate Limits für das Ziel kohärent bleiben.
  • Ein auf ein Land beschränkter Abruf bleibt ohne Neuauswahl innerhalb deiner Allowlist.
  • Der günstige POST /api/single/-Endpoint sendet erneut über einen Proxy, für dessen Erkennung du bereits bezahlt hast, zu den Kosten von Single statt Proxy.

Die Proxy-ID ist ein opaker Base36-String (etwa A1B2C3). Niemals eine reine IP.

Wo sich die ID in einer Response befindet

Endpoint Feld Wann es vorhanden ist
POST /api/auto/ session.proxy Wenn returnSession den Wert true hat (Standard)
POST /api/single/ proxy (Top-Level) Nur wenn der Request ein proxy-Feld übergeben hat
POST /api/proxy/ proxy (Top-Level) Immer, bei Erfolg
POST /api/browser/ proxy (Top-Level) Nur wenn der Request ein proxy-Feld übergeben hat

Um einen neuen Exit ohne Pinning abzurufen, starte mit Auto oder Proxy. Beide ermitteln einen funktionierenden Exit und geben dessen ID für dich zurück.

Muster 1: Auto erkennt, Single wiederholt

Optimal für Ziele, die du noch nicht kennst. Auto durchläuft die Kette einmal, danach verwendet Single die erfolgreiche Session für jede Folgeseite wieder.

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

Lies die Session mit .get() aus. Eine durch einen einfachen Proxy-Fetch gewonnene Session hat proxy und kein userAgent, und manche Antworten enthalten überhaupt keine session.

Der Auto-Aufruf kostet genau das, was seine Ladder verbraucht. Jeder nachfolgende Single-Aufruf kostet 2 Credits (Single mit unblocker, Standard).

Pattern 2: Proxy ermittelt, Browser rendert über denselben Exit

Nutze dies, wenn das Ziel ein bestimmtes Exit-Land sehen muss und der finale Inhalt JavaScript benötigt.

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

Rufe /api/proxy/ nicht erneut auf, um die Auswahl zu aktualisieren. Ein neuer Aufruf wählt möglicherweise einen anderen Exit und macht den Zweck des Pinnings zunichte. Wenn der gepinnte Exit nicht mehr funktioniert, führe einen neuen /api/proxy/-Aufruf aus, um einen neuen zu wählen, und fahre dann damit fort.

Pattern 3: Einen verbrannten Exit überspringen

Wenn ein Exit, der zuvor funktioniert hat, Ablehnungen oder Verifizierungsseiten zurückgibt, weise FourA an, ihn bei der nächsten Auswahl zu meiden.

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

ignoreProxies akzeptiert eine Liste von Proxy-IDs aus frueheren Responses. Es funktioniert auf /api/proxy/ und /api/auto/. Die Liste wird bei jedem internen Retry beruecksichtigt, sodass ein einzelner Call mit ignoreProxies niemals die verbrannten Exits auswaehlt.

Wie lange eine gepinnte Session aktiv bleibt

Der Exit selbst bleibt aktiv, solange der zugrunde liegende Proxy intakt ist, typischerweise Minuten bis Stunden. Wenn ein Replay anfaengt, Challenges, Blocks oder unerwartete Redirects zurueckzugeben, wurde der Exit wahrscheinlich rotiert oder das Ziel hat seine Clearance aktualisiert.

Zwei Optionen in diesem Fall:

  1. Neuer /api/auto/-Call fuer dieselbe URL. Auto findet eine neue funktionierende Session; verwirf die vorherigen IDs.
  2. Neuer /api/proxy/-Call mit ignoreProxies: ["<burned-id>"], wenn du manuell weiter pinnen willst.

Session-Cookies aus einer Auto-Response laufen ebenfalls nach dem Zeitplan des Ziels ab. Manche Websites binden Clearance fuer Stunden, andere fuer Minuten. Behandle die Session wie einen Cache, nicht wie ein dauerhaftes Token.

Wenn sich eine ID nicht pinnen laesst

Drei 400er-Fehler koennen bei einem proxy-Wert zurueckkommen, und sie bedeuten unterschiedliche Dinge:

Error Was passiert ist Was zu tun ist
Invalid proxy format Der Wert ist keine von FourA ausgestellte ID. Eine reine Proxy-Adresse landet hier. Sende den opaken String aus einer Response unveraendert.
Proxy not found Die ID wurde decodiert, loest sich aber nicht mehr zu einem aktiven Exit auf. Verwende einen neuen Exit aus einem neuen Auto- oder Proxy-Call.
Managed exit: this proxy id cannot be pinned to a request Die ID ist ein Premium-Exit und der Premium-Traffic deines Tarifs fuer diesen Zeitraum ist aufgebraucht, oder dein Tarif enthaelt keine Premium-Exits. Fuehre den Call ueber POST /api/proxy/ aus und nutze den Exit, den es auswaehlt, oder buche Premium-Traffic hinzu und pinne ihn erneut.

Der dritte Fehler kann bei einer ID auftreten, die dir ein erfolgreicher Call geliefert hat. Du kannst ihn also erhalten, ohne etwas falsch gemacht zu haben. Behandle ihn wie eine abgelaufene Session: Weiche auf einen neuen Discovery-Call aus, statt dieselbe ID erneut zu versuchen.

Haeufige Fehler

  • Wiederverwendung einer Proxy-ID über mehrere Accounts hinweg. Teile IDs nicht zwischen Accounts: Eine ID, die ein Account anpinnen kann, wird für einen anderen möglicherweise abgelehnt, beispielsweise ein Premium-Exit bei einem Plan ohne Premium-Traffic.
  • Versuch, die ID zu decodieren. Der Base36-String ist opak. Parst ihn nicht, entfernt keine Zeichen und wandelt ihn nicht in Kleinbuchstaben um. Übergebt ihn unverändert.
  • Pinning über einen Exit mit Rate Limit. Wenn das Ziel ein Rate Limit pro IP anwendet, führt das Leiten vieler Requests über einen einzigen Exit schneller zu Sperren. Lasst Auto oder Proxy bei Workloads mit hohem Volumen über viele Exits rotieren und pinnt nur dort, wo das Ziel es zwingend erfordert.
  • Unbeabsichtigtes Pinnen eines Premium-Exits. Eine ID aus einem Call, der über einen Premium-Exit bedient wurde (exitClass: "premium" bei Proxy oder Auto), pinnt einen Premium-Exit. Eine ID aus einem Premium-Auto-Call pinnt einen Premium-Exit bei Single oder Browser, aber nicht zwingend dieselbe Adresse, die Auto verwendet hat. Jeder Replay darüber wird auf deinen Premium-Traffic angerechnet und die Response enthält X-FourA-Exit-Class: premium.
  • Senden von exitCountries bei einem Plan ohne Geo-Targeting. Länder-Scoping ist ab dem Startup-Plan enthalten. Bei einem Plan ohne dieses Feature wird ein Call mit exitCountries mit 403 und X-FourA-Limit: plan_limit_feature abgelehnt.
  • Ignorieren von exitCountries beim Folge-Call. Wenn du einen Exit mit Scope pinnst und danach Proxy erneut ohne exitCountries aufrufst, erfolgt der Folge-Call möglicherweise über ein anderes Land. Behalte den Scope bei jedem Call bei, der ihn benötigt.
Aktualisiert: 5. November 2026