Tài liệu API
Tài khoản, nạp tiền, đơn hàng, mức sử dụng và khóa API qua HTTPS.
Tài liệu · HTTP, HTTPS, SOCKS5
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.
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.
Đị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 |
| 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 |
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ố và hướng dẫn phiên sticky có thêm thông tin.
curl --socks5-hostname gw.banyanproxies.com:7778 \
-U "USERNAME-country-nz-city-wellington:PASSWORD" \
https://ipinfo.io/jsonimport 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"))// 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));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()| 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 |
Tài khoản, nạp tiền, đơn hàng, mức sử dụng và khóa API qua HTTPS.
Quy tắc chính tả và ví dụ cho mọi thành phố.
Số mạng của các ISP gia đình chính.
Từ nạp tiền đến yêu cầu đầu tiên.
Kiểm tra trạng thái dịch vụ trước, sau đó công cụ kiểm tra thành phố proxy nếu nghi ngờ vị trí và bảng thuật ngữ để tra thuật ngữ. Viết cho bộ phận hỗ trợ từ trang liên hệ.
Không. Một gateway phục vụ mọi vị trí; tên người dùng quyết định IP ở đâu.
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.
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.
1 GB 1,88 US$ · nhắm mục tiêu theo thành phố · không cần KYC
Bắt đầu