# Dokumentacja API proxy miejskiego i bramy

> Dokumentacja Banyan Proxies: host i porty bramy, segmenty nazwy użytkownika dla kraju, miasta, ASN i sesji, kody błędów oraz przetestowane przykłady curl, Python i Node.js.

- URL: https://banyanproxies.com/pl/docs/
- Ostatnia aktualizacja: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Wszystko, czego potrzebujesz do połączenia: jedna brama, jeden format nazwy użytkownika i przetestowane przykłady do wklejenia. API konta i zamówień opisano w [dokumentacji API](https://banyanproxies.com/docs/api/).

**Szybka odpowiedź — Jak połączyć się z proxy rezydencjalnymi Banyan Proxies?**

Połącz się z `gw.banyanproxies.com`, port 7777 dla HTTP i HTTPS lub 7778 dla SOCKS5, używając hasła proxy oraz nazwy użytkownika złożonej z segmentów: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Używaj tylko potrzebnych segmentów. Każdy plan, od 1,88 USD za 1 GB, obejmuje targetowanie po mieście i ASN.

## Jakich segmentów nazwy użytkownika mogę używać?

Pełny format: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Zachowaj kolejność; pomiń to, czego nie potrzebujesz.

| Segment | Przykład | Znaczenie |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | Dwuliterowy kod kraju ISO, małymi literami |
| `-city-<name>` | `-city-surabaya` | Nazwa miasta, małymi literami, podkreślenia zamiast spacji |
| `-asn-<number>` | `-asn-7713` | Numer sieci ISP, bez "AS" |
| `-session-<id>` | `-session-cart2` | Przypisuje żądania do jednego sticky IP |
| `-ttl-<minutes>` | `-ttl-20` | Czas utrzymania sesji (sticky), do 30 minut |

## Którego hosta, portów i uwierzytelniania używam?

| Atrybut | Wartość |
| --- | --- |
| Host | `gw.banyanproxies.com` |
| Port HTTP / HTTPS | 7777 |
| Port SOCKS5 | 7778 |
| Uwierzytelnianie | Nazwa użytkownika i hasło w każdym planie lub lista dozwolonych IP (do 10 IP). Podużytkownicy z własnymi danymi logowania i limitem ruchu. Klucze API, które możesz unieważnić w dowolnym momencie |
| Rotacja | Każde nowe połączenie dostaje IP z puli, zwykle inne; aby otrzymać nowe IP przy każdym żądaniu, wysyłaj jedno żądanie na połączenie (wyłącz keep-alive) |
| Sesje sticky | do 30 minut (IP może zmienić się wcześniej) |
| Zablokowane | Strony bankowe, rządowe i portale płatnicze oraz porty SMTP (wysyłanie e-maili) 25, 465 i 587 |

## Które przykłady kodu mogę skopiować?

Każdy przykład żąda jednego IP i wypisuje to, co widzi usługa sprawdzająca. Zastąp USERNAME i PASSWORD. Więcej znajdziesz na [stronie targetowania po mieście](https://banyanproxies.com/pl/targeting/city/) i w [przewodniku po sesjach sticky](https://banyanproxies.com/pl/guides/sticky-sessions/).

*curl przez SOCKS5: IP z Wellington*

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

*Python (httpx): ponów z nową sesją, gdy IP zawiedzie*

```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): jedno IP z 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): przeglądarka z IP z Sydney i pasującą strefą czasową*

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

## Co oznaczają typowe kody błędów?

| Kod lub objaw | Prawdopodobna przyczyna | Co zrobić |
| --- | --- | --- |
| 407 Proxy Authentication Required | Błędna nazwa użytkownika, hasło lub składnia segmentu | Skopiuj dane logowania ponownie; sprawdź myślniki i podkreślenia |
| Timeout przy połączeniu | Zły port lub firewall | Użyj 7777 dla HTTP, 7778 dla SOCKS5 |
| Błędy tylko dla jednego miasta | Za mało domowych urządzeń online w tym miejscu | Ponów później, użyj pobliskiego miasta lub usuń segment miasta |
| 403 lub 429 od celu | Cel odmawia lub ogranicza liczbę żądań | Zwolnij; respektuj warunki serwisu i robots.txt |
| Odmowa połączenia z portem bankowym lub SMTP | Zablokowany cel | Te cele są blokowane przez politykę |

## Gdzie jest reszta dokumentacji?

- **[Dokumentacja API](https://banyanproxies.com/docs/api/)** — Konto, doładowania, zamówienia, zużycie i klucze API przez HTTPS.
- **[Targetowanie na miasto](https://banyanproxies.com/pl/targeting/city/)** — Zasady pisowni i przykłady dla każdego miasta.
- **[Targetowanie ASN](https://banyanproxies.com/pl/targeting/asn/)** — Numery sieci głównych domowych ISP.
- **[Pierwsze kroki](https://banyanproxies.com/pl/guides/getting-started/)** — Od doładowania do pierwszego żądania.

## Gdzie się udać, gdy coś zawiedzie?

Najpierw sprawdź [status usługi](https://banyanproxies.com/pl/status/), potem [sprawdzanie miasta proxy](https://banyanproxies.com/pl/guides/verify-proxy-city/) w razie wątpliwości co do lokalizacji i [glosariusz](https://banyanproxies.com/pl/glossary/) pod kątem terminów. Napisz do pomocy technicznej ze [strony kontaktowej](https://banyanproxies.com/pl/contact/).

## O co jeszcze pytają deweloperzy?

### Czy potrzebuję specjalnego endpointu dla każdego kraju lub miasta?

Nie. Jedna brama obsługuje wszystkie lokalizacje; nazwa użytkownika decyduje, gdzie znajduje się IP.

### Czy mogę użyć listy dozwolonych IP zamiast hasła?

Nazwa użytkownika i hasło w każdym planie lub lista dozwolonych IP (do 10 IP). Podużytkownicy z własnymi danymi logowania i limitem ruchu. Klucze API, które możesz unieważnić w dowolnym momencie.

### Czy przykłady są testowane?

Każdy przykład w Pythonie jest kompilowany, a każdy przykład w JavaScript sprawdzany pod kątem składni przed publikacją. Najpierw zainstaluj wymienione biblioteki: httpx, undici lub Playwright.

---

Banyan Proxies: Banyan Proxies to dostawca proxy rezydencjalnych dla miast w Azji Południowej, Południowo-Wschodniej i Oceanii, z płatnością w kryptowalutach i bez przesyłania dokumentów tożsamości: domowe IP kierowane na miasta takie jak Mumbai, Jakarta, Manila, Bangkok, Karachi, Sydney i inne, rozliczane za GB.