# Tài liệu API proxy theo thành phố và gateway

> Tài liệu Banyan Proxies: host và cổng gateway, các phân đoạn tên người dùng cho quốc gia, thành phố, ASN và phiên, mã lỗi, và mẫu curl, Python và Node.js đã kiểm thử.

- URL: https://banyanproxies.com/vi/docs/
- Cập nhật lần cuối: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Mọi thứ bạn cần để kết nối: một gateway, một định dạng tên người dùng, và các mẫu đã kiểm thử bạn có thể dán vào. API tài khoản và đơn hàng được ghi tại [tài liệu API](https://banyanproxies.com/docs/api/).

**Câu trả lời nhanh — Làm sao để kết nối với proxy dân cư của Banyan Proxies?**

Kết nối đến `gw.banyanproxies.com`, cổng 7777 cho HTTP và HTTPS hoặc 7778 cho SOCKS5, với mật khẩu proxy và tên người dùng ghép từ các phân đoạn: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Chỉ dùng những phân đoạn bạn cần. Mọi gói, từ 1,88 US$ cho 1 GB, đều bao gồm nhắm mục tiêu theo thành phố và ASN.

## Tôi có thể dùng những phân đoạn tên người dùng nào?

Định dạng đầy đủ: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Giữ nguyên thứ tự; bỏ qua những gì bạn không cần.

| Phân đoạn | Ví dụ | Ý nghĩa |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | Mã quốc gia ISO hai chữ cái, viết thường |
| `-city-<name>` | `-city-surabaya` | Tên thành phố, viết thường, dùng dấu gạch dưới thay cho dấu cách |
| `-asn-<number>` | `-asn-7713` | Số mạng ISP, không có "AS" |
| `-session-<id>` | `-session-cart2` | Gắn các yêu cầu với một IP cố định |
| `-ttl-<minutes>` | `-ttl-20` | Thời gian sticky, tối đa 30 phút |

## Tôi dùng host, cổng và xác thực nào?

| Thuộc tính | Giá trị |
| --- | --- |
| Host | `gw.banyanproxies.com` |
| Cổng HTTP / HTTPS | 7777 |
| Cổng SOCKS5 | 7778 |
| Xác thực | Tên đăng nhập và mật khẩu trên mọi gói, hoặc danh sách IP được phép (tối đa 10 IP). Người dùng phụ với thông tin đăng nhập riêng và hạn mức lưu lượng. API key có thể thu hồi bất cứ lúc nào |
| Xoay | Mỗi kết nối mới nhận một IP từ nhóm, thường là IP khác; để nhận IP mới mỗi yêu cầu, hãy gửi một yêu cầu mỗi kết nối (tắt keep-alive) |
| Phiên sticky | tối đa 30 phút (IP có thể thay đổi sớm hơn) |
| Bị chặn | Trang web ngân hàng, chính phủ và cổng thanh toán, cùng với cổng SMTP (gửi email) 25, 465 và 587 |

## Tôi có thể sao chép những mẫu mã nào?

Mỗi mẫu yêu cầu một IP và in ra những gì dịch vụ tra cứu thấy. Thay USERNAME và PASSWORD. [Trang nhắm mục tiêu theo thành phố](https://banyanproxies.com/vi/targeting/city/) và [hướng dẫn phiên sticky](https://banyanproxies.com/vi/guides/sticky-sessions/) có thêm thông tin.

*curl qua SOCKS5: một IP Wellington*

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

*Python (httpx): thử lại với phiên mới khi một IP lỗi*

```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): một IP Thành phố Hồ Chí Minh*

```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): trình duyệt với IP Sydney và múi giờ khớp*

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

## Các mã lỗi phổ biến có nghĩa là gì?

| Mã hoặc triệu chứng | Nguyên nhân khả dĩ | Cần làm gì |
| --- | --- | --- |
| 407 Proxy Authentication Required | Sai tên đăng nhập, mật khẩu hoặc cú pháp phân đoạn | Sao chép lại thông tin đăng nhập; kiểm tra dấu gạch nối và gạch dưới |
| Hết thời gian khi kết nối | Sai cổng hoặc tường lửa | Dùng 7777 cho HTTP, 7778 cho SOCKS5 |
| Chỉ lỗi ở một thành phố | Hiện có ít thiết bị gia đình trực tuyến ở đó | Thử lại sau, dùng thành phố gần đó, hoặc bỏ phân đoạn thành phố |
| 403 hoặc 429 từ mục tiêu | Mục tiêu từ chối hoặc giới hạn tần suất | Giảm tốc độ; tuân thủ điều khoản của trang và robots.txt |
| Kết nối bị từ chối tới cổng ngân hàng hoặc SMTP | Mục tiêu bị chặn | Các mục tiêu này bị chặn theo chính sách |

## Phần còn lại của tài liệu ở đâu?

- **[Tài liệu API](https://banyanproxies.com/docs/api/)** — Tài khoản, nạp tiền, đơn hàng, mức sử dụng và khóa API qua HTTPS.
- **[Nhắm mục tiêu theo thành phố](https://banyanproxies.com/vi/targeting/city/)** — Quy tắc chính tả và ví dụ cho mọi thành phố.
- **[Nhắm mục tiêu theo ASN](https://banyanproxies.com/vi/targeting/asn/)** — Số mạng của các ISP gia đình chính.
- **[Bắt đầu](https://banyanproxies.com/vi/guides/getting-started/)** — Từ nạp tiền đến yêu cầu đầu tiên.

## Tôi đi đâu khi có sự cố?

Kiểm tra [trạng thái dịch vụ](https://banyanproxies.com/vi/status/) trước, sau đó [công cụ kiểm tra thành phố proxy](https://banyanproxies.com/vi/guides/verify-proxy-city/) nếu nghi ngờ vị trí và [bảng thuật ngữ](https://banyanproxies.com/vi/glossary/) để tra thuật ngữ. Viết cho bộ phận hỗ trợ từ [trang liên hệ](https://banyanproxies.com/vi/contact/).

## Lập trình viên còn hỏi gì nữa?

### Tôi có cần endpoint riêng cho mỗi quốc gia hay thành phố không?

Không. Một gateway phục vụ mọi vị trí; tên người dùng quyết định IP ở đâu.

### Tôi có thể dùng danh sách IP được phép thay cho mật khẩu không?

Tên đăng nhập và mật khẩu trên mọi gói, hoặc danh sách IP được phép (tối đa 10 IP). Người dùng phụ với thông tin đăng nhập riêng và hạn mức lưu lượng. API key có thể thu hồi bất cứ lúc nào.

### Các mẫu có được kiểm thử không?

Mỗi mẫu Python đều được biên dịch và mỗi mẫu JavaScript đều được kiểm tra cú pháp trước khi xuất bản. Hãy cài các thư viện được nêu trước: httpx, undici hoặc Playwright.

---

Banyan Proxies: Banyan Proxies là nhà cung cấp proxy dân cư cho các thành phố trên khắp Nam Á, Đông Nam Á và Châu Đại Dương, thanh toán bằng crypto mà không cần tải ID lên: IP nhà riêng được nhắm mục tiêu theo thành phố ở Mumbai, Jakarta, Manila, Bangkok, Karachi, Sydney và nhiều nơi khác, tính phí theo GB.