# City-Proxy-API- und Gateway-Docs

> Banyan Proxies Docs: Gateway-Host und Ports, Benutzernamen-Segmente für Land, Stadt, ASN und Sitzungen, Fehlercodes und getestete curl-, Python- und Node.js-Beispiele.

- URL: https://banyanproxies.com/de/docs/
- Zuletzt aktualisiert: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Alles, was du zum Verbinden brauchst: ein Gateway, ein Benutzernamen-Format und getestete Beispiele zum Einfügen. Die Konto- und Bestell-API ist unter [API-Docs](https://banyanproxies.com/docs/api/) dokumentiert.

**Kurze Antwort — Wie verbinde ich mich mit den Residential-Proxys von Banyan Proxies?**

Verbinde dich mit `gw.banyanproxies.com`, Port 7777 für HTTP und HTTPS oder 7778 für SOCKS5, mit deinem Proxy-Passwort und einem Benutzernamen aus Segmenten: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Verwende nur die Segmente, die du brauchst. Jeder Tarif, ab 1,88 $ für 1 GB, enthält Stadt- und ASN-Targeting.

## Welche Benutzernamen-Segmente kann ich verwenden?

Vollständiges Format: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Behalte die Reihenfolge bei; lass weg, was du nicht brauchst.

| Segment | Beispiel | Bedeutung |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | Zweistelliger ISO-Ländercode, klein geschrieben |
| `-city-<name>` | `-city-surabaya` | Stadtname, klein geschrieben, Unterstriche für Leerzeichen |
| `-asn-<number>` | `-asn-7713` | ISP-Netzwerknummer, ohne "AS" |
| `-session-<id>` | `-session-cart2` | Bindet Anfragen an eine sticky IP |
| `-ttl-<minutes>` | `-ttl-20` | Sticky-Dauer, bis zu 30 Minuten |

## Welchen Host, welche Ports und welche Authentifizierung verwende ich?

| Attribut | Wert |
| --- | --- |
| Host | `gw.banyanproxies.com` |
| HTTP-/HTTPS-Port | 7777 |
| SOCKS5-Port | 7778 |
| Authentifizierung | Benutzername und Passwort in jedem Tarif oder eine IP-Allowlist (bis zu 10 IPs). Sub-User mit eigenen Zugangsdaten und Traffic-Limit. API-Keys, die Sie jederzeit widerrufen können |
| Rotation | Jede neue Verbindung erhält eine IP aus dem Pool, meist eine andere; für eine neue IP bei jeder Anfrage sende eine Anfrage pro Verbindung (Keep-Alive ausschalten) |
| Sticky Sessions | bis zu 30 Minuten (die IP kann früher wechseln) |
| Blockiert | Banking-, Behörden- und Zahlungsportal-Seiten sowie SMTP-Ports (E-Mail-Versand) 25, 465 und 587 |

## Welche Codebeispiele kann ich kopieren?

Jedes Beispiel fordert eine IP an und gibt aus, was ein Lookup-Dienst sieht. Ersetzen Sie USERNAME und PASSWORD. Auf der [Seite zur Städteauswahl](https://banyanproxies.com/de/targeting/city/) und im [Leitfaden für Sticky Sessions](https://banyanproxies.com/de/guides/sticky-sessions/) finden Sie mehr.

*curl über SOCKS5: eine Wellington-IP*

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

*Python (httpx): bei fehlgeschlagener IP mit neuer Session wiederholen*

```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): eine Ho-Chi-Minh-Stadt-IP*

```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): ein Browser mit Sydney-IP und passender Zeitzone*

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

## Was bedeuten gängige Fehlercodes?

| Code oder Symptom | Wahrscheinliche Ursache | Was zu tun ist |
| --- | --- | --- |
| 407 Proxy Authentication Required | Falscher Benutzername, falsches Passwort oder falsche Segment-Syntax | Zugangsdaten erneut kopieren; Bindestriche und Unterstriche prüfen |
| Timeout beim Verbinden | Falscher Port oder eine Firewall | Verwenden Sie 7777 für HTTP, 7778 für SOCKS5 |
| Fehler nur bei einer Stadt | Dort sind aktuell wenige Heimgeräte online | Später erneut versuchen, eine nahe gelegene Stadt verwenden oder das Stadtsegment weglassen |
| 403 oder 429 vom Ziel | Das Ziel lehnt ab oder begrenzt die Rate | Drosseln; die Bedingungen der Website und robots.txt beachten |
| Verbindung zu einem Bank- oder SMTP-Port abgelehnt | Blockiertes Ziel | Diese Ziele sind per Richtlinie blockiert |

## Wo finde ich den Rest der Dokumentation?

- **[API-Dokumentation](https://banyanproxies.com/docs/api/)** — Konto, Aufladungen, Bestellungen, Nutzung und API-Schlüssel über HTTPS.
- **[Stadt-Targeting](https://banyanproxies.com/de/targeting/city/)** — Schreibregeln und Beispiele für jede Stadt.
- **[ASN-Targeting](https://banyanproxies.com/de/targeting/asn/)** — Netzwerknummern der wichtigsten Heim-ISPs.
- **[Erste Schritte](https://banyanproxies.com/de/guides/getting-started/)** — Von der Aufladung bis zur ersten Anfrage.

## Wohin wende ich mich, wenn etwas fehlschlägt?

Prüfen Sie zuerst den [Service-Status](https://banyanproxies.com/de/status/), dann den [Proxy-Städte-Checker](https://banyanproxies.com/de/guides/verify-proxy-city/) bei Standortzweifeln und das [Glossar](https://banyanproxies.com/de/glossary/) für Begriffe. Schreiben Sie den Support über die [Kontaktseite](https://banyanproxies.com/de/contact/).

## Was fragen Entwickler sonst noch?

### Brauche ich einen speziellen Endpunkt pro Land oder Stadt?

Nein. Ein Gateway bedient alle Standorte; der Benutzername entscheidet, wo die IP liegt.

### Kann ich eine IP-Allowlist statt eines Passworts verwenden?

Benutzername und Passwort in jedem Tarif oder eine IP-Allowlist (bis zu 10 IPs). Sub-User mit eigenen Zugangsdaten und Traffic-Limit. API-Keys, die Sie jederzeit widerrufen können.

### Sind die Beispiele getestet?

Jedes Python-Beispiel wird vor der Veröffentlichung kompiliert und jedes JavaScript-Beispiel auf Syntax geprüft. Installiere zuerst die genannten Bibliotheken: httpx, undici oder Playwright.

---

Banyan Proxies: Banyan Proxies ist ein Residential-Proxy-Anbieter für Städte in Süd- und Südostasien und Ozeanien, mit Krypto bezahlen ohne ID-Upload: Heim-IPs gezielt nach Stadt in Mumbai, Jakarta, Manila, Bangkok, Karachi, Sydney und mehr, Abrechnung pro GB.