Réutiliser un proxy entre les requêtes

Découvrez comment conserver la même sortie proxy sur les requêtes suivantes, afin que les rendus JavaScript, les appels API et les récupérations paginées partent tous de la même IP.

Pourquoi réutiliser un proxy

Lorsque vous ciblez un site pour la première fois, FourA choisit un proxy fonctionnel pour vous. Une réponse Proxy ou Auto inclut l'ID du proxy utilisé. Transmettez cet ID lors des requêtes ultérieures et :

  • Les pages suivantes passent par la même sortie, garantissant la cohérence des cookies de session et des rate limits auprès de la cible.
  • Une requête ciblée par pays reste dans votre liste d'autorisation sans nouvelle sélection.
  • L'endpoint économique POST /api/single/ rejoue la requête via un proxy que vous avez déjà payé pour découvrir, au tarif de Single plutôt que de Proxy.

L'ID de proxy est une chaîne opaque en base36 (par exemple A1B2C3). Jamais une IP brute.

Emplacement de l'ID dans une réponse

Endpoint Champ Quand il est présent
POST /api/auto/ session.proxy Lorsque returnSession vaut true (par défaut)
POST /api/single/ proxy (niveau racine) Uniquement si la requête fournissait un champ proxy
POST /api/proxy/ proxy (niveau racine) Toujours, en cas de succès
POST /api/browser/ proxy (niveau racine) Uniquement si la requête fournissait un champ proxy

Pour obtenir une nouvelle sortie sans en fixer une, commencez par Auto ou Proxy. Tous deux détectent une sortie fonctionnelle et vous renvoient son ID.

Modèle 1 : Auto découvre, Single rejoue

Idéal lorsque vous ciblez un site inconnu. Auto parcourt la hiérarchie une fois, puis Single réutilise la session gagnante pour chaque page suivante.

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

Lisez la session avec .get(). Une session obtenue par une simple récupération proxy a proxy et aucun userAgent, et certaines réponses ne contiennent aucun session.

L'appel Auto coûte ce que dépense son ladder. Chaque appel Single de suivi coûte 2 crédits (Single avec unblocker, la valeur par défaut).

Modèle 2 : Proxy découvre, Browser effectue le rendu via la même sortie

Utilisez ceci lorsque la cible doit voir un pays de sortie spécifique et que le contenu final nécessite 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
  }'

N'appelez pas /api/proxy/ à nouveau pour actualiser la sélection. Un nouvel appel peut choisir une sortie différente et annuler l'intérêt de l'épinglage. Si la sortie épinglée cesse de fonctionner, exécutez un nouvel appel /api/proxy/ pour en choisir une nouvelle, puis continuez avec celle-ci.

Modèle 3 : Ignorer une sortie brûlée

Si une sortie qui fonctionnait commence à renvoyer des refus ou des pages de vérification, indiquez à FourA de l'éviter lors de la prochaine sélection.

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

ignoreProxies accepte une liste d'identifiants de proxy issus de réponses précédentes. Il fonctionne sur /api/proxy/ et /api/auto/. La liste est respectée à chaque nouvelle tentative interne, de sorte qu'un appel unique avec ignoreProxies ne sélectionne jamais les sorties brûlées.

Durée de vie d'une session épinglée

La sortie elle-même reste active tant que le proxy sous-jacent est sain, généralement de quelques minutes à quelques heures. Si un rejeu commence à renvoyer des challenges, des blocages ou des redirections inattendues, la sortie a probablement fait l'objet d'une rotation ou la cible a actualisé son autorisation.

Deux options s'offrent à vous dans ce cas :

  1. Nouvel appel /api/auto/ pour la même URL. Auto découvrira une nouvelle session fonctionnelle ; abandonnez les identifiants précédents.
  2. Nouvel appel /api/proxy/ avec ignoreProxies: ["<burned-id>"] si vous souhaitez continuer à épingler manuellement.

Les cookies de session d'une réponse Auto expirent également selon le calendrier propre à la cible. Certains sites conservent l'autorisation pendant des heures, d'autres pendant des minutes. Considérez la session comme un cache, et non comme un jeton durable.

Quand un identifiant ne peut pas être épinglé

Trois erreurs 400 peuvent être renvoyées par une valeur proxy, et elles ont des significations différentes :

Erreur Ce qui s'est passé Que faire
Invalid proxy format La valeur n'est pas un identifiant émis par FourA. Une adresse de proxy brute aboutit ici. Envoyez la chaîne opaque issue d'une réponse, telle quelle.
Proxy not found L'identifiant a été décodé, mais il ne correspond plus à une sortie active. Utilisez une nouvelle sortie issue d'un nouvel appel Auto ou Proxy.
Managed exit: this proxy id cannot be pinned to a request L'identifiant correspond à une sortie premium, et le trafic premium de votre forfait pour cette période est épuisé, ou votre forfait n'inclut pas les sorties premium. Exécutez l'appel via POST /api/proxy/ et acceptez la sortie sélectionnée, ou ajoutez du trafic premium et épinglez-le à nouveau.

La troisième erreur provient d'un identifiant fourni par un appel réussi, vous pouvez donc la rencontrer sans avoir commis d'erreur. Traitez-la comme une session expirée : effectuez un nouvel appel de découverte au lieu de réessayer le même identifiant.

Erreurs fréquentes

  • Réutiliser un ID de proxy entre plusieurs comptes. Ne partagez pas les ID entre comptes : un ID qu'un compte peut épingler peut être refusé pour un autre, par exemple une sortie premium sur un forfait sans trafic premium.
  • Tenter de décoder l'ID. La chaîne base36 est opaque. Ne l'analysez pas, ne supprimez aucun caractère, ne la passez pas en minuscules. Renvoyez-la telle quelle.
  • Épingler une sortie soumise à une limitation de débit. Si la cible applique un rate limit par IP, acheminer de nombreuses requêtes via une seule sortie déclenchera des blocages plus rapidement. Pour les charges de travail à volume élevé, laissez Auto ou Proxy alterner entre plusieurs sorties et n'épinglez que lorsque la cible l'exige réellement.
  • Épingler une sortie premium involontairement. Un ID issu d'un appel servi par une sortie premium (exitClass: "premium" sur Proxy ou Auto) épingle une sortie premium. Un ID provenant d'un appel Auto premium épingle une sortie premium sur Single ou Browser, mais pas nécessairement l'adresse utilisée par Auto. Chaque rejeu via celle-ci est décompté de votre trafic premium, et la réponse inclut X-FourA-Exit-Class: premium.
  • Envoyer exitCountries sur un forfait sans ciblage géographique. Le ciblage par pays est inclus à partir du forfait Startup. Sur un forfait qui ne l'inclut pas, un appel envoyant exitCountries est rejeté avec un 403 et X-FourA-Limit: plan_limit_feature.
  • Ignorer exitCountries lors de l'appel suivant. Si vous épinglez une sortie ciblée géographiquement puis appelez à nouveau Proxy sans exitCountries, l'appel suivant peut aboutir via un autre pays. Conservez le ciblage sur chaque appel qui le nécessite.
Mis à jour : 5 novembre 2026