# Réutiliser un proxy entre les requêtes

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

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.

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

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.

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

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.

```json
{
  "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.

## Pages connexes

- [Endpoints de l'API](https://foura.ai/docs/api/endpoints) : Référence complète des paramètres et des réponses
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch) : Comment Auto établit la session que vous rejouez
- [Sites protégés](https://foura.ai/docs/guides/protected-sites) : Quand l'épinglage est utile et quand la rotation est préférable
- [Problèmes fréquents](https://foura.ai/docs/troubleshooting/common-issues) : `no_eligible_proxy` et autres erreurs de proxy
- [Pourquoi une requête de proxy a épuisé ses tentatives](https://foura.ai/docs/troubleshooting/proxy-attempt-report) : Interpréter `attemptReport` lorsqu'un appel de Proxy abandonne
