选择合适的 Endpoint

FourA 提供三个 API endpoint，每个都针对不同场景进行了优化。选择合适的 endpoint 可以节省时间、降低成本并提高成功率。

快速决策指南

在以下情况下使用 single endpoint：

目标页面是服务端渲染的（不需要 JavaScript）
您需要极高的速度（通常在 1 秒以内）
您正在从 API 或静态 HTML 页面收集数据

在以下情况下使用 browser endpoint：

页面依赖 JavaScript 来渲染内容
内容在初始页面加载后动态加载
您需要完整渲染的 DOM

在以下情况下使用 proxy endpoint：

目标网站主动拦截 request
您需要轮换多个 IP 地址
之前的尝试返回了 403 或 CAPTCHA 页面

Endpoint 对比

Single (`POST /api/single/`)

最快的选择。发送具有真实浏览器特征的 HTTP request，而无需启动浏览器进程。

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com/api/products", "unblocker": true}'

典型 response 时间： 200ms 至 2s 最适合： API、新闻网站、博客、静态产品页面

Browser (`POST /api/browser/`)

在 Chrome 浏览器实例中打开您的 URL。页面将完全加载，执行 JavaScript，并返回最终渲染的 HTML。

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/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'

典型 response 时间： 2s 至 10s 最适合： 单页应用（SPA）、具有懒加载的网站、JavaScript 渲染的内容

Proxy (`POST /api/proxy/`)

将 HTTP request 与自动 proxy 轮换相结合。如果第一次尝试失败或被拦截，FourA 将通过不同的 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,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing",
      "unblocker": true
    }
  }'

典型 response 时间： 1s 至 5s 最适合： 电商价格监控、旅游信息聚合、具有机器人检测的网站

何时结合使用不同方法

某些工作流可以从使用多个 endpoint 中受益：

从 single 开始：测试页面在没有浏览器的情况下是否返回有用数据。
回退到 browser：如果 response 为空或缺少内容，请切换到浏览器渲染。
添加 proxy：如果您被拦截（403/CAPTCHA），请将您的 request 包装在 proxy endpoint 中以进行自动 IP 轮换。

这种渐进式方法可以在最大程度提高成功率的同时保持低成本。

性能技巧

默认使用 single endpoint，仅在需要时进行升级
在 browser request 中设置 checkText 以避免等待不必要的内容
在 proxy request 中设置 maxTries 以控制重试行为（默认为 5，最大为 90）
保持合理的 timeout_ms 值：大多数页面为 10 到 15 秒

后续步骤

API Endpoints：完整参数参考
抓取动态网站：逐步 browser request 指南
快速开始：在 30 秒内完成您的首次 request

更新于： 2026年6月30日