# シティプロキシAPIとゲートウェイドキュメント

> Banyan Proxiesドキュメント：ゲートウェイホストとポート、国・都市・ASN・セッション用のユーザー名セグメント、エラーコード、テスト済みのcurl、Python、Node.jsサンプル。

- URL: https://banyanproxies.com/ja/docs/
- 最終更新日: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

接続に必要なすべて：1つのゲートウェイ、1つのユーザー名形式、貼り付けるだけのテスト済みサンプル。アカウントと注文APIは[APIドキュメント](https://banyanproxies.com/docs/api/)に記載されています。

**クイック回答 — Banyan Proxiesのレジデンシャルプロキシに接続するにはどうすればよいですか？**

`gw.banyanproxies.com`に接続し、HTTPおよびHTTPSにはポート7777、SOCKS5にはポート7778を使用します。プロキシパスワードと、セグメントから構築したユーザー名（`USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`）を入力します。必要なセグメントのみを使用してください。1 GBで$1.88のプランを含め、すべてのプランに都市とASNのターゲティングが含まれています。

## どのユーザー名セグメントを使用できますか？

完全な形式：`USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`。順序を守り、不要なものは省略してください。

| セグメント | 例 | 意味 |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | 2文字のISO国コード（小文字） |
| `-city-<name>` | `-city-surabaya` | 都市名（小文字、スペースはアンダースコア） |
| `-asn-<number>` | `-asn-7713` | ISPネットワーク番号（「AS」なし） |
| `-session-<id>` | `-session-cart2` | リクエストを1つのスティッキーIPに紐付けます |
| `-ttl-<minutes>` | `-ttl-20` | スティッキー持続時間、最大30分 |

## どのホスト、ポート、認証を使えばいいですか？

| 属性 | 値 |
| --- | --- |
| ホスト | `gw.banyanproxies.com` |
| HTTP / HTTPSポート | 7777 |
| SOCKS5ポート | 7778 |
| 認証 | すべてのプランでユーザー名とパスワード、またはIP許可リスト（最大10 IP）。独自の認証情報とトラフィック上限を持つサブユーザー。いつでも失効できるAPIキー |
| ローテーション | 新しい接続ごとにプールからIPが割り当てられ、通常は異なるIPになります。リクエストごとに新しいIPを取得するには、1接続につき1リクエストを送信してください（keep-aliveをオフ） |
| スティッキーセッション | 最大30分（IPはそれより早く変わる場合があります） |
| ブロック済み | 銀行、政府、決済ポータルのサイト、およびSMTP（メール送信）ポート25、465、587 |

## コピーできるコードサンプルはどれですか？

各サンプルは1つのIPをリクエストし、ルックアップサービスが見る内容を出力します。USERNAMEとPASSWORDを置き換えてください。[都市ターゲティングページ](https://banyanproxies.com/ja/targeting/city/)と[スティッキーセッションガイド](https://banyanproxies.com/ja/guides/sticky-sessions/)に詳細があります。

*SOCKS5経由のcurl: WellingtonのIP*

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

*Python (httpx): IPが失敗したら新しいセッションでリトライ*

```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): Ho Chi Minh CityのIPを1つ*

```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): SydneyのIPと一致するタイムゾーンを持つブラウザ*

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

## よくあるエラーコードの意味は？

| コードまたは症状 | 考えられる原因 | 対処方法 |
| --- | --- | --- |
| 407 Proxy Authentication Required | ユーザー名、パスワード、またはセグメント構文が間違っている | 認証情報をもう一度コピーし、ハイフンとアンダースコアを確認 |
| 接続時のタイムアウト | ポートが間違っている、またはファイアウォール | HTTPには7777、SOCKS5には7778を使用 |
| 特定の1都市だけでエラー | 現在そこにオンラインの家庭用デバイスが少ない | 後でリトライする、近くの都市を使う、または都市セグメントを外す |
| ターゲットからの403または429 | ターゲットが拒否またはレート制限している | 速度を落とす。サイトの利用規約とrobots.txtを尊重する |
| 銀行またはSMTPポートへの接続拒否 | ブロックされたターゲット | これらのターゲットはポリシーによりブロックされています |

## 残りのドキュメントはどこにありますか？

- **[APIドキュメント](https://banyanproxies.com/docs/api/)** — アカウント、チャージ、注文、使用状況、APIキーをHTTPS経由で。
- **[都市ターゲティング](https://banyanproxies.com/ja/targeting/city/)** — 全都市のスペル規則と例。
- **[ASNターゲティング](https://banyanproxies.com/ja/targeting/asn/)** — 主要な家庭用ISPのネットワーク番号。
- **[はじめに](https://banyanproxies.com/ja/guides/getting-started/)** — チャージから最初のリクエストまで。

## 失敗したときはどこへ行けばいいですか？

まず[サービスステータス](https://banyanproxies.com/ja/status/)を確認し、場所の疑問には[プロキシ都市チェッカー](https://banyanproxies.com/ja/guides/verify-proxy-city/)、用語には[用語集](https://banyanproxies.com/ja/glossary/)を確認してください。[お問い合わせページ](https://banyanproxies.com/ja/contact/)からサポートに書き込んでください。

## 開発者は他に何を尋ねますか？

### 国や都市ごとに専用のエンドポイントが必要ですか？

いいえ。1つのゲートウェイがすべてのロケーションに対応し、IPの場所はユーザー名で決まります。

### パスワードの代わりにIP許可リストを使えますか？

すべてのプランでユーザー名とパスワード、またはIP許可リスト（最大10 IP）。独自の認証情報とトラフィック上限を持つサブユーザー。いつでも失効できるAPIキー.

### サンプルはテスト済みですか？

各Pythonサンプルは公開前にコンパイルされ、各JavaScriptサンプルは構文チェックされます。まずサンプルに記載されたライブラリ（httpx、undici、Playwright）をインストールしてください。

---

Banyan Proxies: Banyan Proxies は南アジア・東南アジア・オセアニアの各都市に対応したレジデンシャルプロキシプロバイダーです。暗号通貨で支払い、本人確認書類のアップロードは不要。ムンバイ、ジャカルタ、マニラ、バンコク、カラチ、シドニーなどの都市別にターゲティングした家庭用IPを、GB単位で課金します。