# Documentazione API proxy per città e gateway

> Documentazione di Banyan Proxies: host e porte del gateway, segmenti dello username per paese, città, ASN e sessioni, codici di errore e esempi testati in curl, Python e Node.js.

- URL: https://banyanproxies.com/it/docs/
- Ultimo aggiornamento: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Tutto ciò che ti serve per connetterti: un unico gateway, un unico formato di username e esempi testati che puoi incollare. L'API per account e ordini è documentata nella [documentazione API](https://banyanproxies.com/docs/api/).

**Risposta rapida — Come mi connetto ai proxy residenziali di Banyan Proxies?**

Connettiti a `gw.banyanproxies.com`, porta 7777 per HTTP e HTTPS oppure 7778 per SOCKS5, con la tua password del proxy e uno username composto da segmenti: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Usa solo i segmenti che ti servono. Ogni piano, a partire da 1,88 USD per 1 GB, include il targeting per città e ASN.

## Quali segmenti dello username posso usare?

Formato completo: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Mantieni l'ordine; ometti ciò che non ti serve.

| Segmento | Esempio | Significato |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | Codice paese ISO a due lettere, minuscolo |
| `-city-<name>` | `-city-surabaya` | Nome della città, minuscolo, con underscore al posto degli spazi |
| `-asn-<number>` | `-asn-7713` | Numero di rete ISP, senza "AS" |
| `-session-<id>` | `-session-cart2` | Associa le richieste a un unico IP sticky |
| `-ttl-<minutes>` | `-ttl-20` | Durata sticky, fino a 30 minuti |

## Quali host, porte e autenticazione uso?

| Attributo | Valore |
| --- | --- |
| Host | `gw.banyanproxies.com` |
| Porta HTTP / HTTPS | 7777 |
| Porta SOCKS5 | 7778 |
| Autenticazione | Username e password su ogni piano, oppure una allowlist IP (fino a 10 IP). Sub-utenti con proprie credenziali e limite di traffico. Chiavi API revocabili in qualsiasi momento |
| Rotazione | Ogni nuova connessione riceve un IP dal pool, di solito diverso; per ottenere un nuovo IP a ogni richiesta, invia una richiesta per connessione (disattiva il keep-alive) |
| Sessioni sticky | fino a 30 minuti (l'IP può cambiare prima) |
| Bloccato | Siti bancari, governativi e portali di pagamento, più le porte SMTP (invio email) 25, 465 e 587 |

## Quali esempi di codice posso copiare?

Ogni esempio richiede un IP e stampa ciò che vede un servizio di lookup. Sostituisci USERNAME e PASSWORD. La [pagina di targeting per città](https://banyanproxies.com/it/targeting/city/) e la [guida alle sessioni sticky](https://banyanproxies.com/it/guides/sticky-sessions/) hanno ulteriori dettagli.

*curl su SOCKS5: un IP di Wellington*

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

*Python (httpx): riprova con una nuova sessione quando un IP fallisce*

```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): un IP di Ho Chi Minh City*

```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 browser con un IP di Sydney e fuso orario corrispondente*

```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()
```

## Cosa significano i codici di errore più comuni?

| Codice o sintomo | Causa probabile | Cosa fare |
| --- | --- | --- |
| 407 Proxy Authentication Required | Username, password o sintassi del segmento errati | Copia di nuovo le credenziali; controlla trattini e underscore |
| Timeout alla connessione | Porta errata o un firewall | Usa 7777 per HTTP, 7778 per SOCKS5 |
| Errori solo per una città | Pochi dispositivi domestici online lì in questo momento | Riprova più tardi, usa una città vicina o rimuovi il segmento della città |
| 403 o 429 dal target | Il target rifiuta o applica un rate limit | Rallenta; rispetta i termini del sito e robots.txt |
| Connessione rifiutata verso una porta bancaria o SMTP | Target bloccato | Questi target sono bloccati da policy |

## Dove trovo il resto della documentazione?

- **[Documentazione API](https://banyanproxies.com/docs/api/)** — Account, ricariche, ordini, utilizzo e chiavi API su HTTPS.
- **[Targeting città](https://banyanproxies.com/it/targeting/city/)** — Regole di ortografia ed esempi per ogni città.
- **[Targeting ASN](https://banyanproxies.com/it/targeting/asn/)** — Numeri di rete dei principali ISP domestici.
- **[Per iniziare](https://banyanproxies.com/it/guides/getting-started/)** — Dalla ricarica alla prima richiesta.

## Dove vado quando qualcosa fallisce?

Controlla prima lo [stato del servizio](https://banyanproxies.com/it/status/), poi il [proxy city checker](https://banyanproxies.com/it/guides/verify-proxy-city/) per dubbi sulla posizione e il [glossario](https://banyanproxies.com/it/glossary/) per i termini. Scrivi al supporto dalla [pagina dei contatti](https://banyanproxies.com/it/contact/).

## Cos'altro chiedono gli sviluppatori?

### Serve un endpoint speciale per ogni paese o città?

No. Un unico gateway serve tutte le località; è il nome utente a decidere dove si trova l'IP.

### Posso usare una allowlist di IP invece di una password?

Username e password su ogni piano, oppure una allowlist IP (fino a 10 IP). Sub-utenti con proprie credenziali e limite di traffico. Chiavi API revocabili in qualsiasi momento.

### Gli esempi vengono testati?

Ogni esempio Python viene compilato e ogni esempio JavaScript viene verificato sintatticamente prima della pubblicazione. Prima installa le librerie indicate: httpx, undici o Playwright.

---

Banyan Proxies: Banyan Proxies è un fornitore di proxy residenziali per città in Asia meridionale, Sud-est asiatico e Oceania, pagati in crypto senza caricare documenti: IP residenziali mirati per città a Mumbai, Jakarta, Manila, Bangkok, Karachi, Sydney e altre, fatturati per GB.