创建任务

本指南将指导你创建 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 下方提供可直接运行的 curl 命令及 Copy command 按钮。在手机或平板设备上，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 会自动选择成本最低且可行的方案：direct request、rotating proxy 或 full browser。最适合用于抓取尚未明确反爬机制的新目标站点。

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：尝试浏览器 Request

如果目标页面使用 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 则重新生成

后续步骤

控制台概览：完整的控制台使用指南
Playground：在编写代码前于控制台中测试 request
Smart Fetch (Auto)：深入了解 auto endpoint
选择合适的 Endpoint：详细对比
常见问题：快速排查并解决问题

更新于： 2026年9月30日