複数リクエスト間でのproxyの再利用

JavaScriptのレンダリング、API呼び出し、ページネーションされた取得がすべて同じIPから行われるよう、後続のリクエスト全体で同じproxy出口を維持する方法を説明します。

proxyを再利用する理由

ターゲットに最初にアクセスした際、FourAは自動的に有効なproxyを選択します。ProxyまたはAutoのレスポンスには、使用されたproxy IDが含まれます。以降のリクエストでそのIDを渡すことで、以下の利点が得られます。

  • 後続ページが同じ出口を経由するため、ターゲットに対してセッションcookieとレート制限の一貫性が保たれます。
  • 国を指定した取得において、新規選択を行わずに許可リスト内に留まります。
  • コストの低いPOST /api/single/エンドポイントを使用し、すでに探索コストを支払ったproxyをProxyではなくSingleのコストで再利用できます。

proxy IDは不透明なbase36文字列です(例: A1B2C3)。生のIPアドレスではありません。

レスポンス内のIDの場所

エンドポイント フィールド 含まれる条件
POST /api/auto/ session.proxy returnSessionがtrue(デフォルト)の場合
POST /api/single/ proxy(トップレベル) リクエストにproxyフィールドが指定された場合のみ
POST /api/proxy/ proxy(トップレベル) 成功時は常に含まれる
POST /api/browser/ proxy(トップレベル) リクエストにproxyフィールドが指定された場合のみ

固定せずに新しい出口を取得するには、AutoまたはProxyから開始してください。どちらも有効な出口を検出し、そのIDを返します。

パターン 1: Autoが検出し、Singleが再利用する

まだ状態が不明なターゲットに最適です。Autoがラダーを1回実行した後、Singleがその成功セッションをすべての後続ページで再利用します。

import requests

API = "https://eu.api.foura.ai"
H = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}

# Step 1: discover a working exit with Auto.
r = requests.post(f"{API}/api/auto/", headers=H, json={
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
}).json()

session = r.get("session") or {}
proxy = session.get("proxy")
user_agent = session.get("userAgent")

# Step 2: paginate with Single, reusing the same exit, User-Agent and cookies.
for sku in ("43", "44", "45"):
    body = {"method": "GET", "url": f"https://example.com/product/{sku}"}
    if proxy:
        body["proxy"] = proxy
    headers = []
    if user_agent:
        headers.append(["User-Agent", user_agent])
    if session.get("cookies"):
        headers.append(["Cookie", "; ".join(f"{c['name']}={c['value']}" for c in session["cookies"])])
    if headers:
        body["headers"] = headers
    p = requests.post(f"{API}/api/single/", headers=H, json=body).json()
    print(sku, p["status"])

.get() でセッションを読み取ります。通常の proxy fetch で取得したセッションには proxy が含まれ、userAgent は含まれません。また、応答によっては session がまったく含まれない場合もあります。

Auto 呼び出しのコストは、そのラダーで消費された分となります。後続の各 Single 呼び出しには 2 クレジットかかります(unblocker を指定した Single、デフォルト)。

パターン 2: Proxy が検出し、Browser が同一の出口経由でレンダリングする

ターゲットに特定の出口国を認識させる必要があり、最終コンテンツに JavaScript が必要な場合に使用します。

# Step 1: pick a country-scoped exit with Proxy.
curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "exitCountries": ["FR", "GB"],
    "request": {"method": "GET", "url": "https://example.com/pricing"}
  }'
# Response includes: "proxy": "A1B2C3", "exitCountry": "FR"

# Step 2: render the JS-heavy page through THAT exit.
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/pricing",
    "proxy": "A1B2C3",
    "timeout_ms": 20000
  }'

選択を更新するために /api/proxy/ を再度呼び出さないでください。新しい呼び出しにより別の出口が選択され、固定の意味が失われる可能性があります。固定された出口が機能しなくなった場合は、新しく /api/proxy/ を呼び出して新しい出口を選択し、それを使用して続行してください。

パターン3: 使用不能になった出口をスキップする

以前は機能していた出口が拒絶や検証ページを返し始めた場合は、次回の選択時にそれを回避するよう FourA に指示します。

{
  "maxTries": 5,
  "ignoreProxies": ["A1B2C3"],
  "request": { "method": "GET", "url": "https://example.com/data" }
}

ignoreProxies は以前のレスポンスから取得したプロキシ ID のリストを受け入れます。/api/proxy/ および /api/auto/ で動作します。リストはすべての内部リトライで適用されるため、ignoreProxies を指定した1回の呼び出しで失効した出口が選択されることはありません。

固定セッションの有効期間

出口自体は、基盤となるプロキシが正常である限り存続し、通常は数分から数時間です。リプレイがチャレンジ、ブロック、または予期しないリダイレクトを返し始めた場合、出口がローテーションされたか、ターゲットがクリアランスを更新した可能性があります。

その場合の2つのオプション:

  1. 同じ URL に対して新しい /api/auto/ 呼び出しを実行する。Auto が新しい有効なセッションを検出し、以前の ID は破棄されます。
  2. 手動での固定を継続する場合は、ignoreProxies: ["<burned-id>"] を指定して新しい /api/proxy/ 呼び出しを実行する。

Auto レスポンスからのセッション Cookie も、ターゲット側のスケジュールに基づいて期限切れになります。クリアランスを数時間保持するサイトもあれば、数分で失効させるサイトもあります。セッションは永続的なトークンではなく、キャッシュとして扱ってください。

ID を固定できない場合

proxy の値から返される可能性のある 400 エラーは3つあり、それぞれ意味が異なります:

エラー 発生した問題 対処方法
Invalid proxy format 値が FourA によって発行された ID ではありません。生のプロキシアドレスがここに該当します。 レスポンスから取得した不透明な文字列をそのまま送信してください。
Proxy not found ID はデコードされましたが、有効な出口に解決されなくなりました。 新しい Auto または Proxy 呼び出しから新しい出口を取得してください。
Managed exit: this proxy id cannot be pinned to a request ID がプレミアム出口であり、今期のプランのプレミアムトラフィックを使い果たしたか、プランにプレミアム出口が含まれていません。 POST /api/proxy/ を介して呼び出しを実行し、選択された出口を使用するか、プレミアムトラフィックを追加して再度固定してください。

3つ目のエラーは、成功した呼び出しから返された ID から発生するため、誤った操作をしていなくても遭遇する可能性があります。期限切れのセッションと同様に扱い、同じ ID をリトライするのではなく、新しい検出呼び出しへとフォールバックしてください。

よくある間違い

  • アカウント間での proxy ID の再利用。 アカウント間で ID を共有しないでください。あるアカウントで固定できる ID であっても、別のアカウントでは拒否される場合があります(例: プレミアムトラフィックのないプランでのプレミアム exit)。
  • ID のデコードの試行。 base36 文字列は不透明(opaque)です。パースしたり、文字を削除したり、小文字化したりしないでください。そのまま渡してください。
  • レート制限された exit の固定。 ターゲットが IP ごとに rate limit を適用している場合、1 つの exit に多数の request を集中させるとブロックが早く発生します。大量のワークロードでは、Auto または Proxy に多数の exit をローテーションさせ、ターゲットが真に必要とする場合にのみ固定してください。
  • 意図しないプレミアム exit の固定。 プレミアム exit が処理した呼び出し(Proxy または Auto での exitClass: "premium")からの ID は、プレミアム exit を固定します。プレミアム Auto 呼び出しからの ID は Single または Browser でプレミアム exit を固定しますが、必ずしも Auto が使用したアドレスとは限りません。それを通じた各リプレイはプレミアムトラフィックとしてカウントされ、response には X-FourA-Exit-Class: premium が含まれます。
  • ジオターゲティングのないプランでの exitCountries の送信。 国のスコープ指定は Startup プラン以上で含まれます。これを含まないプランでは、exitCountries を送信する呼び出しは 403 および X-FourA-Limit: plan_limit_feature で拒否されます。
  • 後続のリクエストでの exitCountries の指定漏れ。 スコープ指定された exit を固定し、その後 exitCountries なしで再度 Proxy を呼び出すと、後続のリクエストが別の国を経由する可能性があります。スコープが必要なすべての呼び出しでスコープを維持してください。
最終更新日: 2026年11月5日