API 문서
계정, 충전, 주문, 사용량, API 키를 HTTPS로 관리합니다.
문서 · HTTP, HTTPS, SOCKS5
연결에 필요한 모든 것: 하나의 게이트웨이, 하나의 사용자 이름 형식, 그리고 붙여넣을 수 있는 테스트된 샘플. 계정 및 주문 API는 API 문서에 설명되어 있습니다.
빠른 답변
Banyan Proxies 레지덴셜 프록시에 어떻게 연결하나요?
프록시 비밀번호와 세그먼트로 구성된 사용자 이름을 사용하여 gw.banyanproxies.com, HTTP 및 HTTPS용 포트 7777 또는 SOCKS5용 포트 7778에 연결하세요: USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15. 필요한 세그먼트만 사용하세요. 1 GB에 US$1.88부터 시작하는 모든 요금제에는 도시 및 ASN 타겟팅이 포함됩니다.
전체 형식: USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}. 순서를 유지하고, 필요 없는 부분은 생략하세요.
| 세그먼트 | 예시 | 의미 |
|---|---|---|
-country-<cc> | -country-id | 두 글자 ISO 국가 코드, 소문자 |
-city-<name> | -city-surabaya | 도시 이름, 소문자, 공백은 밑줄로 |
-asn-<number> | -asn-7713 | ISP 네트워크 번호, "AS" 제외 |
-session-<id> | -session-cart2 | 요청을 하나의 고정 IP에 묶음 |
-ttl-<minutes> | -ttl-20 | 고정 세션 지속 시간, 최대 30분 |
| 호스트 | gw.banyanproxies.com |
|---|---|
| HTTP / HTTPS 포트 | 7777 |
| SOCKS5 포트 | 7778 |
| 인증 | 모든 요금제에서 사용자 이름과 비밀번호, 또는 IP 허용 목록(최대 10개 IP). 자체 자격 증명과 트래픽 한도를 가진 하위 사용자. 언제든지 폐기할 수 있는 API 키 |
| 로테이션 | 새 연결마다 풀에서 IP를 받고 보통 다른 IP가 할당됩니다. 요청마다 새 IP를 받으려면 연결당 요청 하나를 보내세요(keep-alive 끄기) |
| 고정 세션 | 최대 30분 (IP는 더 일찍 바뀔 수 있음) |
| 차단됨 | 뱅킹, 정부 및 결제 포털 사이트, 그리고 SMTP(이메일 발송) 포트 25, 465, 587 |
각 샘플은 IP 하나를 요청하고 조회 서비스가 보는 내용을 출력합니다. USERNAME과 PASSWORD를 바꾸세요. 자세한 내용은 도시 타겟팅 페이지와 고정 세션 가이드에서 확인하세요.
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()| 코드 또는 증상 | 가능한 원인 | 대처 방법 |
|---|---|---|
| 407 Proxy Authentication Required | 사용자 이름, 비밀번호 또는 세그먼트 구문 오류 | 자격 증명을 다시 복사하고 하이픈과 밑줄을 확인하세요 |
| 연결 시간 초과 | 잘못된 포트 또는 방화벽 | HTTP는 7777, SOCKS5는 7778을 사용하세요 |
| 특정 도시에서만 오류 발생 | 현재 해당 지역에 온라인인 가정 기기가 적음 | 나중에 재시도하거나 인근 도시를 사용하거나 도시 세그먼트를 제거하세요 |
| 대상에서 403 또는 429 | 대상이 거부하거나 속도 제한 중 | 속도를 줄이고 사이트 약관과 robots.txt를 준수하세요 |
| 은행 또는 SMTP 포트 연결 거부 | 차단된 대상 | 이 대상은 정책상 차단되어 있습니다 |
먼저 서비스 상태를 확인한 뒤, 위치가 의심되면 프록시 도시 확인기를, 용어는 용어집을 확인하세요. 문의 페이지에서 지원팀에 글을 보내세요.
아니요. 하나의 게이트웨이가 모든 위치를 처리하며, 사용자 이름이 IP 위치를 결정합니다.
모든 요금제에서 사용자 이름과 비밀번호, 또는 IP 허용 목록(최대 10개 IP). 자체 자격 증명과 트래픽 한도를 가진 하위 사용자. 언제든지 폐기할 수 있는 API 키.
각 Python 샘플은 게시 전에 컴파일되고 각 JavaScript 샘플은 구문 검사를 거칩니다. 먼저 명시된 라이브러리를 설치하세요: httpx, undici 또는 Playwright.
1 GB US$1.88 · 도시 타겟팅 · KYC 없이
시작하기