# Documentation de l'API proxy par ville et de la passerelle

> Documentation Banyan Proxies : hôte et ports de la passerelle, segments de nom d'utilisateur pour le pays, la ville, l'ASN et les sessions, codes d'erreur et exemples testés en curl, Python et Node.js.

- URL: https://banyanproxies.com/fr/docs/
- Dernière mise à jour: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Tout ce qu'il faut pour vous connecter : une passerelle, un format de nom d'utilisateur et des exemples testés à copier-coller. L'API de compte et de commande est documentée dans la [documentation API](https://banyanproxies.com/docs/api/).

**Réponse rapide — Comment me connecter aux proxy résidentiels Banyan Proxies ?**

Connectez-vous à `gw.banyanproxies.com`, port 7777 pour HTTP et HTTPS ou 7778 pour SOCKS5, avec votre mot de passe proxy et un nom d'utilisateur construit à partir de segments : `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Utilisez uniquement les segments dont vous avez besoin. Chaque forfait, dès 1,88 $US pour 1 GB, inclut le ciblage par ville et par ASN.

## Quels segments de nom d'utilisateur puis-je utiliser ?

Format complet : `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Respectez l'ordre ; omettez ce dont vous n'avez pas besoin.

| Segment | Exemple | Signification |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | Code pays ISO à deux lettres, en minuscules |
| `-city-<name>` | `-city-surabaya` | Nom de la ville, en minuscules, tirets bas pour les espaces |
| `-asn-<number>` | `-asn-7713` | Numéro de réseau ISP, sans "AS" |
| `-session-<id>` | `-session-cart2` | Associe les requêtes à une seule IP fixe |
| `-ttl-<minutes>` | `-ttl-20` | Durée sticky, jusqu'à 30 minutes |

## Quel hôte, quels ports et quelle authentification dois-je utiliser ?

| Attribut | Valeur |
| --- | --- |
| Hôte | `gw.banyanproxies.com` |
| Port HTTP / HTTPS | 7777 |
| Port SOCKS5 | 7778 |
| Authentification | Nom d'utilisateur et mot de passe sur chaque forfait, ou une liste d'IP autorisées (jusqu'à 10 IP). Sous-utilisateurs avec leurs propres identifiants et plafond de trafic. Clés API révocables à tout moment |
| Rotation | Chaque nouvelle connexion reçoit une IP du pool, généralement différente ; pour obtenir une nouvelle IP à chaque requête, envoyez une requête par connexion (désactivez keep-alive) |
| Sessions sticky | jusqu'à 30 minutes (l'IP peut changer plus tôt) |
| Bloqué | Sites bancaires, gouvernementaux et de portails de paiement, plus les ports SMTP (envoi d'e-mails) 25, 465 et 587 |

## Quels exemples de code puis-je copier ?

Chaque exemple demande une IP et affiche ce que voit un service de lookup. Remplacez USERNAME et PASSWORD. La [page de ciblage par ville](https://banyanproxies.com/fr/targeting/city/) et le [guide des sessions sticky](https://banyanproxies.com/fr/guides/sticky-sessions/) en disent plus.

*curl via SOCKS5 : une IP de Wellington*

```bash
curl --socks5-hostname gw.banyanproxies.com:7778 \
  -U "USERNAME-country-nz-city-wellington:PASSWORD" \
  https://ipinfo.io/json
```

*Python (httpx) : réessayer avec une nouvelle session quand une IP échoue*

```python
import uuid

import httpx

HOST = "gw.banyanproxies.com"
PORT = 7777


def fetch(url, city="lahore", country="pk", tries=3):
    for _ in range(tries):
        sid = uuid.uuid4().hex[:8]
        user = f"USERNAME-country-{country}-city-{city}-session-{sid}-ttl-10"
        proxy = f"http://{user}:PASSWORD@{HOST}:{PORT}"
        try:
            with httpx.Client(proxy=proxy, timeout=30) as client:
                r = client.get(url)
                r.raise_for_status()
                return r.text
        except httpx.HTTPError as exc:
            print("retrying with a new IP:", exc)
    return None


print(fetch("https://ipinfo.io/json"))
```

*Node.js (undici) : une IP de Hô Chi Minh-Ville*

```javascript
// npm install undici
const { ProxyAgent, fetch } = require("undici");

const user = "USERNAME-country-vn-city-ho_chi_minh_city";
const token = "Basic " + Buffer.from(`${user}:PASSWORD`).toString("base64");
const dispatcher = new ProxyAgent({
  uri: "http://gw.banyanproxies.com:7777",
  token,
});

async function main() {
  const res = await fetch("https://ipinfo.io/json", { dispatcher });
  const info = await res.json();
  console.log(info.ip, info.city, info.region);
}

main().catch((err) => console.error(err.message));
```

*Playwright (Python) : un navigateur avec une IP de Sydney et le fuseau horaire correspondant*

```python
from playwright.sync_api import sync_playwright

PROXY = {
    "server": "http://gw.banyanproxies.com:7777",
    "username": "USERNAME-country-au-city-sydney-session-syd1-ttl-15",
    "password": "PASSWORD",
}

with sync_playwright() as p:
    browser = p.chromium.launch(proxy=PROXY)
    context = browser.new_context(
        timezone_id="Australia/Sydney",
        locale="en-AU",
    )
    page = context.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.inner_text("body"))
    browser.close()
```

## Que signifient les codes d'erreur courants ?

| Code ou symptôme | Cause probable | Que faire |
| --- | --- | --- |
| 407 Proxy Authentication Required | Nom d'utilisateur, mot de passe ou syntaxe de segment incorrects | Recopiez les identifiants ; vérifiez les tirets et les underscores |
| Timeout à la connexion | Mauvais port ou un pare-feu | Utilisez 7777 pour HTTP, 7778 pour SOCKS5 |
| Erreurs pour une seule ville | Peu d'appareils domestiques en ligne à cet endroit en ce moment | Réessayez plus tard, utilisez une ville voisine ou retirez le segment de ville |
| 403 ou 429 renvoyé par la cible | La cible refuse ou limite le débit | Ralentissez ; respectez les conditions du site et le robots.txt |
| Connexion refusée vers un port bancaire ou SMTP | Cible bloquée | Ces cibles sont bloquées par politique |

## Où se trouve le reste de la documentation ?

- **[Docs API](https://banyanproxies.com/docs/api/)** — Compte, recharges, commandes, utilisation et clés API via HTTPS.
- **[Ciblage par ville](https://banyanproxies.com/fr/targeting/city/)** — Règles d'orthographe et exemples pour chaque ville.
- **[Ciblage par ASN](https://banyanproxies.com/fr/targeting/asn/)** — Numéros de réseau des principaux ISP domestiques.
- **[Premiers pas](https://banyanproxies.com/fr/guides/getting-started/)** — De la recharge à la première requête.

## Où aller quand quelque chose échoue ?

Consultez d'abord le [statut du service](https://banyanproxies.com/fr/status/), puis le [vérificateur de ville du proxy](https://banyanproxies.com/fr/guides/verify-proxy-city/) en cas de doute sur la localisation et le [glossaire](https://banyanproxies.com/fr/glossary/) pour les termes. Écrivez au support depuis la [page de contact](https://banyanproxies.com/fr/contact/).

## Que demandent d'autre les développeurs ?

### Ai-je besoin d'un endpoint spécifique par pays ou par ville ?

Non. Une seule passerelle dessert tous les emplacements ; le nom d'utilisateur détermine l'emplacement de l'IP.

### Puis-je utiliser une liste blanche d'IP au lieu d'un mot de passe ?

Nom d'utilisateur et mot de passe sur chaque forfait, ou une liste d'IP autorisées (jusqu'à 10 IP). Sous-utilisateurs avec leurs propres identifiants et plafond de trafic. Clés API révocables à tout moment.

### Les exemples sont-ils testés ?

Chaque exemple Python est compilé et chaque exemple JavaScript est vérifié syntaxiquement avant publication. Installez d'abord les bibliothèques qu'ils mentionnent : httpx, undici ou Playwright.

---

Banyan Proxies: Banyan Proxies est un fournisseur de proxies résidentiels pour les villes d'Asie du Sud, d'Asie du Sud-Est et d'Océanie, payable en crypto sans envoi de pièce d'identité : des IP domestiques ciblées par ville à Mumbai, Jakarta, Manille, Bangkok, Karachi, Sydney et ailleurs, facturées au GB.