# Dokumentasi API proxy kota dan gateway

> Dokumentasi Banyan Proxies: host dan port gateway, segmen nama pengguna untuk negara, kota, ASN dan sesi, kode error, serta contoh curl, Python dan Node.js yang telah diuji.

- URL: https://banyanproxies.com/id/docs/
- Terakhir diperbarui: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Semua yang Anda butuhkan untuk terhubung: satu gateway, satu format nama pengguna, dan contoh teruji yang bisa langsung ditempel. API akun dan pesanan didokumentasikan di [dokumentasi API](https://banyanproxies.com/docs/api/).

**Jawaban singkat — Bagaimana cara terhubung ke proxy residensial Banyan Proxies?**

Hubungkan ke `gw.banyanproxies.com`, port 7777 untuk HTTP dan HTTPS atau 7778 untuk SOCKS5, dengan kata sandi proxy Anda dan nama pengguna yang dibentuk dari segmen: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Gunakan hanya segmen yang Anda perlukan. Setiap paket, mulai dari US$1,88 untuk 1 GB, mencakup penargetan kota dan ASN.

## Segmen nama pengguna apa saja yang bisa saya gunakan?

Format lengkap: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Pertahankan urutannya; hilangkan yang tidak Anda perlukan.

| Segmen | Contoh | Arti |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | Kode negara ISO dua huruf, huruf kecil |
| `-city-<name>` | `-city-surabaya` | Nama kota, huruf kecil, garis bawah untuk spasi |
| `-asn-<number>` | `-asn-7713` | Nomor jaringan ISP, tanpa "AS" |
| `-session-<id>` | `-session-cart2` | Mengikat permintaan ke satu IP sticky |
| `-ttl-<minutes>` | `-ttl-20` | Durasi sticky, hingga 30 menit |

## Host, port, dan autentikasi apa yang saya gunakan?

| Atribut | Nilai |
| --- | --- |
| Host | `gw.banyanproxies.com` |
| Port HTTP / HTTPS | 7777 |
| Port SOCKS5 | 7778 |
| Autentikasi | Username dan password di setiap paket, atau allowlist IP (hingga 10 IP). Sub-pengguna dengan kredensial dan batas trafik sendiri. API key yang dapat Anda cabut kapan saja |
| Rotasi | Setiap koneksi baru mendapat IP dari pool, biasanya berbeda; untuk mendapat IP baru di setiap permintaan, kirim satu permintaan per koneksi (matikan keep-alive) |
| Sesi sticky | hingga 30 menit (IP bisa berubah lebih cepat) |
| Diblokir | Situs perbankan, pemerintah, dan portal pembayaran, plus port SMTP (pengiriman email) 25, 465, dan 587 |

## Contoh kode mana yang bisa saya salin?

Setiap contoh meminta satu IP dan mencetak apa yang dilihat oleh layanan lookup. Ganti USERNAME dan PASSWORD. [Halaman penargetan kota](https://banyanproxies.com/id/targeting/city/) dan [panduan sesi sticky](https://banyanproxies.com/id/guides/sticky-sessions/) memiliki informasi lebih lanjut.

*curl melalui SOCKS5: IP Wellington*

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

*Python (httpx): coba lagi dengan sesi baru saat IP gagal*

```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): satu IP 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): browser dengan IP Sydney dan zona waktu yang sesuai*

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

## Apa arti kode error yang umum?

| Kode atau gejala | Kemungkinan penyebab | Yang harus dilakukan |
| --- | --- | --- |
| 407 Proxy Authentication Required | Username, password, atau sintaks segmen salah | Salin kredensial lagi; periksa tanda hubung dan garis bawah |
| Timeout saat connect | Port salah atau firewall | Gunakan 7777 untuk HTTP, 7778 untuk SOCKS5 |
| Error hanya untuk satu kota | Sedikit perangkat rumah yang online di sana saat ini | Coba lagi nanti, gunakan kota terdekat, atau hapus segmen kota |
| 403 atau 429 dari target | Target menolak atau membatasi laju | Perlambat; patuhi ketentuan situs dan robots.txt |
| Connection refused ke bank atau port SMTP | Target diblokir | Target ini diblokir oleh kebijakan |

## Di mana sisa dokumentasinya?

- **[Dokumentasi API](https://banyanproxies.com/docs/api/)** — Akun, top-up, pesanan, penggunaan, dan API key melalui HTTPS.
- **[Penargetan kota](https://banyanproxies.com/id/targeting/city/)** — Aturan penulisan dan contoh untuk setiap kota.
- **[Penargetan ASN](https://banyanproxies.com/id/targeting/asn/)** — Nomor jaringan ISP rumah utama.
- **[Memulai](https://banyanproxies.com/id/guides/getting-started/)** — Dari top-up hingga permintaan pertama.

## Ke mana saya harus pergi saat ada yang gagal?

Periksa [status layanan](https://banyanproxies.com/id/status/) terlebih dahulu, lalu [pemeriksa kota proxy](https://banyanproxies.com/id/guides/verify-proxy-city/) untuk keraguan lokasi dan [glosarium](https://banyanproxies.com/id/glossary/) untuk istilah. Tulis ke support dari [halaman kontak](https://banyanproxies.com/id/contact/).

## Apa lagi yang ditanyakan para developer?

### Apakah saya perlu endpoint khusus per negara atau kota?

Tidak. Satu gateway melayani semua lokasi; username yang menentukan lokasi IP-nya.

### Bisakah saya menggunakan allowlist IP alih-alih kata sandi?

Username dan password di setiap paket, atau allowlist IP (hingga 10 IP). Sub-pengguna dengan kredensial dan batas trafik sendiri. API key yang dapat Anda cabut kapan saja.

### Apakah sampelnya diuji?

Setiap sampel Python dikompilasi dan setiap sampel JavaScript diperiksa sintaksnya sebelum dipublikasikan. Instal dulu library yang disebutkan: httpx, undici, atau Playwright.

---

Banyan Proxies: Banyan Proxies adalah penyedia proxy residensial untuk kota-kota di seluruh Asia Selatan, Asia Tenggara, dan Oseania, dibayar dengan kripto tanpa unggah ID: IP rumahan yang ditargetkan per kota di Mumbai, Jakarta, Manila, Bangkok, Karachi, Sydney, dan lainnya, ditagih per GB.