跨请求重用代理

了解如何在后续 request 中保持相同的 proxy 出口,使 JavaScript 渲染、API 调用和分页抓取均来自同一 IP。

为何复用 Proxy

首次请求目标时,FourA 会为你挑选一个可用的 proxy。Proxy 或 Auto response 中会包含所使用的 proxy ID。在后续 request 中传回该 ID 可以:

  • 后续页面通过相同出口访问,保持 session cookie 和 rate limit 对目标的一致性。
  • 限制国家范围的抓取可保留在允许列表中,无需重新筛选。
  • 成本较低的 POST /api/single/ endpoint 通过你已付费发现的 proxy 重放,仅按 Single 而非 Proxy 计费。

proxy ID 是不透明的 base36 字符串(类似于 A1B2C3),绝非原始 IP。

ID 在 Response 中的位置

Endpoint 字段 出现时机
POST /api/auto/ session.proxy 当 returnSession 为 true(默认值)时
POST /api/single/ proxy(顶层) 仅当 request 提供 proxy 字段时
POST /api/proxy/ proxy(顶层) 成功时始终存在
POST /api/browser/ proxy(顶层) 仅当 request 提供 proxy 字段时

若要获取全新出口而不固定出口,请从 Auto 或 Proxy 开始。二者都会探测可用出口并返回其 ID 供你使用。

模式 1:Auto 探测,Single 重放

适用于未知目标。Auto 遍历一次梯队,然后 Single 为每个后续页面复用该优胜 session。

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() 读取 session。通过普通 proxy 请求获取的 session 包含 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 接收来自先前 response 的 proxy ID 列表。它适用于 /api/proxy/ 和 /api/auto/。该列表在每次内部重试时均生效,因此带有 ignoreProxies 的单次调用绝不会选择已失效的出口。

固定 Session 的有效时长

只要底层 proxy 状态健康,出口本身就会保持存活,通常为数分钟到数小时不等。如果重放请求开始返回 challenge、拦截或非预期的重定向,则该出口可能已被轮换,或目标站点刷新了其 clearance 状态。

发生这种情况时有两种选择:

  1. 针对同一 URL 发起全新的 /api/auto/ 调用。Auto 会自动发现新的可用 session;请丢弃之前的 ID。
  2. 如果希望继续手动固定,发起带有 ignoreProxies: ["<burned-id>"] 的全新 /api/proxy/ 调用。

Auto response 中的 session cookie 也会根据目标站点自身的规则过期。某些站点会将 clearance 绑定数小时;其他站点则仅维持数分钟。应将 session 视为缓存,而非持久 token。

无法固定 ID 的情况

proxy 值可能返回三种 400 错误,它们代表不同的含义:

错误 发生原因 解决办法
Invalid proxy format 该值不是 FourA 签发的 ID。传入原始 proxy 地址会导致此错误。 逐字发送来自 response 的不透明字符串。
Proxy not found ID 已成功解码,但不再解析为活跃的出口。 从新的 Auto 或 Proxy 调用中获取全新的出口。
Managed exit: this proxy id cannot be pinned to a request 该 ID 属于高级出口,但您当前周期的套餐高级流量已用尽,或您的套餐不包含高级出口。 通过 POST /api/proxy/ 运行调用并接受其选择的出口,或者增加高级流量配额后重新固定。

第三种错误可能由成功调用所返回的 ID 触发,因此即使操作完全正确也可能遇到。请按照处理过期 session 的方式应对:回退到全新的发现调用,而不是重试相同的 ID。

常见错误

  • **跨账户复用 proxy ID。**切勿在账户之间共享 ID:一个账户可以固定的 ID 可能会被另一个账户拒绝,例如在没有高级流量的套餐中使用高级出口。
  • **尝试解码 ID。**此 base36 字符串是不透明的。不要解析它,不要截断字符,也不要转换为小写。请原样传回。
  • **通过受 rate limit 限制的出口进行固定。**如果目标网站按 IP 进行 rate limit,将大量 request 集中到一个出口会更快触发封禁。对于高并发工作负载,建议让 Auto 或 Proxy 轮换多个出口,仅在目标确实需要时才进行固定。
  • **无意中固定了高级出口。**由高级出口提供服务的调用(Proxy 或 Auto 上的 exitClass: "premium")所返回的 ID 会固定高级出口。来自高级 Auto 调用的 ID 会在 Single 或 Browser 上固定高级出口,但不一定是 Auto 当时使用的具体地址。每次通过它重放都会计入您的高级流量配额,并且 response 会携带 X-FourA-Exit-Class: premium。
  • **在不支持地理定位的套餐上发送 exitCountries。**国家/地区作用域从 Startup 套餐起包含。在未包含该功能的套餐上,发送 exitCountries 的调用将被拒绝,并返回 403 和 X-FourA-Limit: plan_limit_feature。
  • **在后续调用中忽略 exitCountries。**如果您固定了指定作用域的出口,随后再次调用 Proxy 时未携带 exitCountries,后续调用可能会通过其他国家/地区路由。请在每个需要的调用中保持该作用域。
更新于: 2026年11月5日