创建任务
本指南将指导你创建 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 则重新生成 |
后续步骤
- 控制台概览:完整控制台操作指南
- Playground:在编写代码前于控制台中测试请求
- Smart Fetch (Auto):深入了解 auto endpoint
- 选择合适的 Endpoint:详细对比
- 常见问题:快速排查并解决问题