本指南将指导你创建 API key 并使用 FourA Dashboard 发送你的第一个 request。

第 1 步:打开 Dashboard

访问 Dashboard 并登录你的 FourA 账户。

第 2 步:创建 API Key

进入 API Keys 页面并点击 Create API key。拥有 key 之后,列表上方的按钮会显示为 Create Key。

为该 key 输入一个描述性名称(例如 "production-scraper" 或 "dev-testing")。API Key Created 对话框会显示明文 key 及复制按钮,并在 Test your first request 下方提供带 Copy command 的即用型 curl 命令。在手机或平板电脑上,Try it in the Playground 则会带你跳转至相应演练场。

如果不慎关闭,稍后点击该 key 所在行的眼睛图标可再次查看。在显示功能上线前创建的旧版 key 无法再次查看;重新生成一次即可切换。完整流程参见:Managing API Keys。

你的 key 样式如下:pk_live_a1b2c3d4e5f6...

第 3 步:选择 Endpoint

FourA 提供四个针对不同场景的 endpoint:

Auto (POST /api/auto/)

智能默认选项。传入 URL,最好附带 validate 规则,FourA 会逐步尝试从轮换 proxy 到通过 proxy 运行的完整浏览器,并在获得首个通过校验的响应时停止。设置 forceProxy: false 可让其优先尝试直接 request。最适合用于目标为全新站点且尚不清楚其具体要求的情况。

Single (POST /api/single/)

发送快速 HTTP request。最适合静态 HTML 页面和 API endpoint。响应时间:通常在 2 秒以内。

Browser (POST /api/browser/)

运行 Chrome 浏览器实例以渲染 JavaScript。最适合 SPA、懒加载内容以及需要执行 JS 的页面。响应时间:2 到 10 秒。

Proxy (POST /api/proxy/)

通过轮换 proxy 路由 request 并自动重试。最适合会检查请求来源身份或按国家/地区返回不同内容的站点。

第 4 步:发送你的第一个 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"}'

步骤 5:读取 Response

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<html>...</html>",
  "total_time": 0.45
}

headers 字段是一个对象数组,每个重定向跳转对应一项。每个条目都包含一个 result,其中包含状态行以及目标返回的每个 response header。

关键字段:

  • status:来自目标网站的 HTTP 状态码
  • data:response body(HTML、JSON 或原始文本)
  • total_time:request 耗时(秒)

步骤 6:尝试浏览器请求

如果目标页面使用 JavaScript 渲染内容,请改用浏览器 endpoint:

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/products", "timeout_ms": 15000}'

浏览器响应使用 body 而不是 data:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

常见问题

问题 解决方案
不确定使用哪个引擎 从 auto endpoint 开始。它会自动选择合适的路径并记住有效方案。
内容为空 从 single 切换到 browser endpoint:该页面可能需要 JS 渲染
响应中出现验证页面 切换到 proxy endpoint 以启用自动 IP 轮换
超时 增加 timeout_ms 或验证 URL 是否正确
Key 丢失 在 API Keys 中点击该 key 所在行的眼睛图标以显示,若是旧版 key 则重新生成

后续步骤

更新于: 2026年10月28日