跨请求重用代理
了解如何在后续 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 状态。
发生这种情况时有两种选择:
- 针对同一 URL 发起全新的
/api/auto/调用。Auto 会自动发现新的可用 session;请丢弃之前的 ID。 - 如果希望继续手动固定,发起带有
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,后续调用可能会通过其他国家/地区路由。请在每个需要的调用中保持该作用域。
相关内容
- API Endpoints:完整参数与 response 参考
- Smart Fetch (Auto):Auto 如何构建供您重放的 session
- 受保护网站:何时固定有效以及何时轮换更佳
- 常见问题:
no_eligible_proxy及其他 proxy 错误 - Proxy Request 耗尽重试次数的原因:在 Proxy 调用放弃时解读
attemptReport