Sans KYC — pas de pièce d'identité, pas de selfie, pas de documents · Ciblage par ville sur chaque forfait · Paiement en crypto
Langue: Français
Commencer

Documentation · HTTP, HTTPS, SOCKS5

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

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.

Dernière mise à jour: · 4 min de lecture

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.

SegmentExempleSignification
-country-<cc>-country-idCode pays ISO à deux lettres, en minuscules
-city-<name>-city-surabayaNom de la ville, en minuscules, tirets bas pour les espaces
-asn-<number>-asn-7713Numéro de réseau ISP, sans "AS"
-session-<id>-session-cart2Associe les requêtes à une seule IP fixe
-ttl-<minutes>-ttl-20Durée sticky, jusqu'à 30 minutes

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

Hôtegw.banyanproxies.com
Port HTTP / HTTPS7777
Port SOCKS57778
AuthentificationNom 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
RotationChaque 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 stickyjusqu'à 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 et le guide des sessions sticky en disent plus.

curl via SOCKS5 : une IP de Wellington
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
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
// 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
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ômeCause probableQue faire
407 Proxy Authentication RequiredNom d'utilisateur, mot de passe ou syntaxe de segment incorrectsRecopiez les identifiants ; vérifiez les tirets et les underscores
Timeout à la connexionMauvais port ou un pare-feuUtilisez 7777 pour HTTP, 7778 pour SOCKS5
Erreurs pour une seule villePeu d'appareils domestiques en ligne à cet endroit en ce momentRéessayez plus tard, utilisez une ville voisine ou retirez le segment de ville
403 ou 429 renvoyé par la cibleLa cible refuse ou limite le débitRalentissez ; respectez les conditions du site et le robots.txt
Connexion refusée vers un port bancaire ou SMTPCible bloquéeCes cibles sont bloquées par politique

Où se trouve le reste de la documentation ?

Où aller quand quelque chose échoue ?

Consultez d'abord le statut du service, puis le vérificateur de ville du proxy en cas de doute sur la localisation et le glossaire pour les termes. Écrivez au support depuis la page de 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.

1 GB 1,88 $US · ciblage par ville · sans KYC

Commencer