# Documentatie voor city proxy API en gateway

> Banyan Proxies docs: gatewayhost en -poorten, gebruikersnaamsegmenten voor land, stad, ASN en sessies, foutcodes en geteste curl-, Python- en Node.js-voorbeelden.

- URL: https://banyanproxies.com/nl/docs/
- Laatst bijgewerkt: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Alles wat je nodig hebt om verbinding te maken: één gateway, één gebruikersnaamformaat en geteste voorbeelden die je kunt plakken. De account- en order-API staat gedocumenteerd onder [API docs](https://banyanproxies.com/docs/api/).

**Snel antwoord — Hoe maak ik verbinding met de residentiële proxy's van Banyan Proxies?**

Maak verbinding met `gw.banyanproxies.com`, poort 7777 voor HTTP en HTTPS of 7778 voor SOCKS5, met je proxywachtwoord en een gebruikersnaam opgebouwd uit segmenten: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Gebruik alleen de segmenten die je nodig hebt. Elk plan, vanaf US$ 1,88 voor 1 GB, bevat targeting op stad en ASN.

## Welke gebruikersnaamsegmenten kan ik gebruiken?

Volledig formaat: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Houd de volgorde aan; laat weg wat je niet nodig hebt.

| Segment | Voorbeeld | Betekenis |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | Tweeletterige ISO-landcode, kleine letters |
| `-city-<name>` | `-city-surabaya` | Stadsnaam, kleine letters, underscores voor spaties |
| `-asn-<number>` | `-asn-7713` | ISP-netwerknummer, zonder "AS" |
| `-session-<id>` | `-session-cart2` | Koppelt verzoeken aan één sticky IP |
| `-ttl-<minutes>` | `-ttl-20` | Sticky-duur, tot 30 minuten |

## Welke host, poorten en authenticatie gebruik ik?

| Eigenschap | Waarde |
| --- | --- |
| Host | `gw.banyanproxies.com` |
| HTTP / HTTPS-poort | 7777 |
| SOCKS5-poort | 7778 |
| Authenticatie | Gebruikersnaam en wachtwoord bij elk plan, of een IP-allowlist (tot 10 IP's). Subgebruikers met eigen inloggegevens en verkeerslimiet. API-sleutels die je op elk moment kunt intrekken |
| Rotatie | Elke nieuwe verbinding krijgt een IP uit de pool, meestal een ander; om bij elk verzoek een nieuw IP te krijgen, stuur je één verzoek per verbinding (zet keep-alive uit) |
| Sticky sessies | tot 30 minuten (het IP kan eerder wisselen) |
| Geblokkeerd | Bank-, overheids- en betaalportaalsites, plus SMTP-poorten (voor e-mailverzending) 25, 465 en 587 |

## Welke codevoorbeelden kan ik kopiëren?

Elk voorbeeld vraagt één IP aan en toont wat een lookup-service ziet. Vervang USERNAME en PASSWORD. De [pagina voor stadsgerichte targeting](https://banyanproxies.com/nl/targeting/city/) en de [handleiding voor sticky sessies](https://banyanproxies.com/nl/guides/sticky-sessions/) bevatten meer.

*curl via SOCKS5: een IP uit Wellington*

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

*Python (httpx): opnieuw proberen met een nieuwe sessie wanneer een IP faalt*

```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): één IP uit Ho Chi Minhstad*

```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): een browser met een IP uit Sydney en bijpassende tijdzone*

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

## Wat betekenen veelvoorkomende foutcodes?

| Code of symptoom | Waarschijnlijke oorzaak | Wat te doen |
| --- | --- | --- |
| 407 Proxy Authentication Required | Verkeerde gebruikersnaam, wachtwoord of segment-syntaxis | Kopieer de inloggegevens opnieuw; controleer koppeltekens en underscores |
| Timeout bij verbinden | Verkeerde poort of een firewall | Gebruik 7777 voor HTTP, 7778 voor SOCKS5 |
| Fouten bij slechts één stad | Daar zijn nu weinig thuisapparaten online | Probeer later opnieuw, gebruik een nabijgelegen stad of laat het stadssegment weg |
| 403 of 429 van het doelwit | Het doelwit weigert of beperkt het aantal verzoeken | Vertraag; respecteer de voorwaarden en robots.txt van de site |
| Verbinding geweigerd naar een bank- of SMTP-poort | Geblokkeerd doelwit | Deze doelwitten zijn geblokkeerd door beleid |

## Waar vind ik de rest van de documentatie?

- **[API-documentatie](https://banyanproxies.com/docs/api/)** — Account, opwaarderingen, bestellingen, gebruik en API-sleutels via HTTPS.
- **[Stad-targeting](https://banyanproxies.com/nl/targeting/city/)** — Spellingsregels en voorbeelden voor elke stad.
- **[ASN-targeting](https://banyanproxies.com/nl/targeting/asn/)** — Netwerknummers van de belangrijkste thuis-ISP's.
- **[Aan de slag](https://banyanproxies.com/nl/guides/getting-started/)** — Van opwaardering tot eerste verzoek.

## Waar ga ik naartoe als iets mislukt?

Controleer eerst de [servicestatus](https://banyanproxies.com/nl/status/), dan de [proxy-stadschecker](https://banyanproxies.com/nl/guides/verify-proxy-city/) bij twijfel over de locatie en de [woordenlijst](https://banyanproxies.com/nl/glossary/) voor termen. Neem contact op met support via de [contactpagina](https://banyanproxies.com/nl/contact/).

## Wat vragen ontwikkelaars nog meer?

### Heb ik een speciaal endpoint per land of stad nodig?

Nee. Eén gateway bedient elke locatie; de gebruikersnaam bepaalt waar het IP vandaan komt.

### Kan ik een IP-allowlist gebruiken in plaats van een wachtwoord?

Gebruikersnaam en wachtwoord bij elk plan, of een IP-allowlist (tot 10 IP's). Subgebruikers met eigen inloggegevens en verkeerslimiet. API-sleutels die je op elk moment kunt intrekken.

### Worden de voorbeelden getest?

Elk Python-voorbeeld wordt gecompileerd en elk JavaScript-voorbeeld wordt op syntax gecontroleerd voordat het wordt gepubliceerd. Installeer eerst de genoemde libraries: httpx, undici of Playwright.

---

Banyan Proxies: Banyan Proxies is een aanbieder van residentiële proxy's voor steden in Zuid- en Zuidoost-Azië en Oceanië, betaald in crypto zonder ID-upload: thuis-IP's per stad in Mumbai, Jakarta, Manilla, Bangkok, Karachi, Sydney en meer, afgerekend per GB.