# Şehir proxy API ve gateway dokümanları

> Banyan Proxies dokümanları: gateway sunucusu ve portları, ülke, şehir, ASN ve oturumlar için kullanıcı adı bölümleri, hata kodları ve test edilmiş curl, Python ve Node.js örnekleri.

- URL: https://banyanproxies.com/tr/docs/
- Son güncelleme: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Bağlanmak için ihtiyacınız olan her şey: tek bir gateway, tek bir kullanıcı adı formatı ve yapıştırabileceğiniz test edilmiş örnekler. Hesap ve sipariş API'si [API dokümanları](https://banyanproxies.com/docs/api/) altında belgelenmiştir.

**Hızlı yanıt — Banyan Proxies konut proxy'lerine nasıl bağlanırım?**

HTTP ve HTTPS için `gw.banyanproxies.com`, port 7777 veya SOCKS5 için 7778 adresine, proxy şifreniz ve bölümlerden oluşturulmuş bir kullanıcı adıyla bağlanın: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Yalnızca ihtiyacınız olan bölümleri kullanın. 1 GB için $1,88'dan başlayan her plan şehir ve ASN hedeflemesi içerir.

## Hangi kullanıcı adı bölümlerini kullanabilirim?

Tam format: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Sırayı koruyun; ihtiyacınız olmayanı atlayın.

| Bölüm | Örnek | Anlam |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | İki harfli ISO ülke kodu, küçük harfle |
| `-city-<name>` | `-city-surabaya` | Şehir adı, küçük harfle, boşluklar için alt çizgi |
| `-asn-<number>` | `-asn-7713` | ISP ağ numarası, "AS" olmadan |
| `-session-<id>` | `-session-cart2` | İstekleri tek bir sticky IP'ye bağlar |
| `-ttl-<minutes>` | `-ttl-20` | Sticky süre, 30 dakikaya kadar |

## Hangi host, port ve kimlik doğrulama kullanılır?

| Özellik | Değer |
| --- | --- |
| Host | `gw.banyanproxies.com` |
| HTTP / HTTPS portu | 7777 |
| SOCKS5 portu | 7778 |
| Kimlik doğrulama | Her planda kullanıcı adı ve şifre veya bir IP izin listesi (en fazla 10 IP). Kendi kimlik bilgilerine ve trafik üst limitine sahip alt kullanıcılar. İstediğiniz zaman iptal edebileceğiniz API anahtarları |
| Döndürme | Her yeni bağlantı havuzdan bir IP alır, genellikle farklı bir IP; her istekte yeni IP almak için bağlantı başına bir istek gönderin (keep-alive'ı kapatın) |
| Sticky oturumlar | 30 dakikaya kadar (IP daha erken değişebilir) |
| Engellendi | Bankacılık, devlet ve ödeme portalı siteleri ile SMTP (e-posta gönderme) portları 25, 465 ve 587 |

## Hangi kod örneklerini kopyalayabilirim?

Her örnek bir IP talep eder ve bir sorgulama servisinin ne gördüğünü yazdırır. USERNAME ve PASSWORD değerlerini değiştirin. [Şehir hedefleme sayfasında](https://banyanproxies.com/tr/targeting/city/) ve [sticky oturumlar rehberinde](https://banyanproxies.com/tr/guides/sticky-sessions/) daha fazlası var.

*SOCKS5 üzerinden curl: bir Wellington IP'si*

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

*Python (httpx): bir IP başarısız olduğunda yeni oturumla yeniden dene*

```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): bir Ho Chi Minh City IP'si*

```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): Sidney IP'si ve eşleşen saat dilimiyle bir tarayıcı*

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

## Yaygın hata kodları ne anlama gelir?

| Kod veya belirti | Muhtemel neden | Ne yapmalı |
| --- | --- | --- |
| 407 Proxy Authentication Required | Yanlış kullanıcı adı, parola veya segment sözdizimi | Kimlik bilgilerini yeniden kopyalayın; tire ve alt çizgileri kontrol edin |
| Bağlantıda zaman aşımı | Yanlış port veya bir güvenlik duvarı | HTTP için 7777, SOCKS5 için 7778 kullanın |
| Yalnızca tek bir şehir için hatalar | Şu anda orada çevrimiçi az sayıda ev cihazı var | Daha sonra yeniden deneyin, yakın bir şehir kullanın veya şehir segmentini kaldırın |
| Hedeften 403 veya 429 | Hedef reddediyor veya hız sınırı koyuyor | Yavaşlayın; sitenin koşullarına ve robots.txt kurallarına uyun |
| Bir banka veya SMTP portuna bağlantı reddedildi | Engellenen hedef | Bu hedefler politika gereği engellenmiştir |

## Belgelerin geri kalanı nerede?

- **[API dokümantasyonu](https://banyanproxies.com/docs/api/)** — Hesap, bakiye yüklemeleri, siparişler, kullanım ve API anahtarları HTTPS üzerinden.
- **[Şehir hedeflemesi](https://banyanproxies.com/tr/targeting/city/)** — Her şehir için yazım kuralları ve örnekler.
- **[ASN hedeflemesi](https://banyanproxies.com/tr/targeting/asn/)** — Ana ev ISP'lerinin ağ numaraları.
- **[Başlangıç](https://banyanproxies.com/tr/guides/getting-started/)** — Bakiye yüklemeden ilk talebe.

## Bir şey başarısız olduğunda nereye başvurmalıyım?

Önce [servis durumunu](https://banyanproxies.com/tr/status/) kontrol edin, konum şüpheleri için [proxy şehir denetleyicisine](https://banyanproxies.com/tr/guides/verify-proxy-city/) ve terimler için [sözlüğe](https://banyanproxies.com/tr/glossary/) bakın. [İletişim sayfasından](https://banyanproxies.com/tr/contact/) desteğe yazın.

## Geliştiriciler başka neler soruyor?

### Ülke veya şehir başına özel bir endpoint'e ihtiyacım var mı?

Hayır. Tek bir gateway tüm konumlara hizmet eder; IP'nin nerede olacağını kullanıcı adı belirler.

### Şifre yerine IP allowlist kullanabilir miyim?

Her planda kullanıcı adı ve şifre veya bir IP izin listesi (en fazla 10 IP). Kendi kimlik bilgilerine ve trafik üst limitine sahip alt kullanıcılar. İstediğiniz zaman iptal edebileceğiniz API anahtarları.

### Örnekler test edildi mi?

Her Python örneği yayınlanmadan önce derlenir ve her JavaScript örneğinin sözdizimi kontrol edilir. Önce belirttikleri kütüphaneleri yükleyin: httpx, undici veya Playwright.

---

Banyan Proxies: Banyan Proxies, Güney ve Güneydoğu Asya ile Okyanusya'daki şehirler için konut proxy sağlayıcısıdır; kripto ile ödeme, kimlik yükleme yok: Mumbai, Jakarta, Manila, Bangkok, Karachi, Sydney ve daha fazlasında şehir bazında hedeflenen ev IP'leri, GB başına faturalandırılır.