演练场
Playground(侧边栏 > Playground)允许你使用真实密钥直接运行实时 API request,无需编写任何代码。这是测试新目标网站、调试异常 response 或横向对比 Auto、Single、Proxy 和 Browser 的最快方式。
访问地址:foura.ai/dashboard#playground。
功能概述
一个表单,四种引擎,真实流量。
- Auto:智能抓取。传入 URL 以及
validate规则,FourA 会自动选择可用且成本最低的路径。 - Single:直接 HTTP 抓取,具备贴近真实浏览器的网络传输特征
- Proxy:托管式轮换 proxy 抓取,可按需限定目标可见的国家/地区
- Browser:在 Chrome 浏览器实例中打开 URL,用于 JS 渲染的站点
Request 会使用你在页面顶部选择的 API key 发起。使用量会像生产环境调用一样计入该 key 的配额,因此请注意测试时的用量消耗。
选择密钥
API key 下拉列表包含所有可用活动 key:My Keys 下属于你个人的 key,以及按你所属组织划分的 key 组。任何成员均可调用所属组织的 key,其产生的 request 将计入组织所有者的套餐用量。请选择计费归属的对应 key。如果你尚无活动 key,内联提示会引导你前往 API Keys 页面创建。
选择模式
顶部的 Mode 行可在 Auto 和手动引擎之间切换。选择 Auto 时,表单会切换为极简的 Auto 界面(URL 加上 validate 以及少量配置项)。两行始终显示:Mode: Auto,以及 Endpoint: Single、Proxy、Browser。选中其中一个会自动取消另一个的选中状态。切换 endpoint 会改变可见字段以及 request 实际调用的引擎。页面重新加载时会保留当前选择。
| 模式 | 适用场景 |
|---|---|
| Auto | 新目标或多重防护站点。Auto 会自动选择成本最低的可用路径并记录有效方案。 |
| Single | 快速 HTTP 抓取。已知目标 host 的首选方案。 |
| Proxy | 支持自动 proxy 轮换的同类抓取。需要指定目标可见的国家/地区时,请配置 exitCountries。 |
| Browser | 在 Chrome 浏览器实例中加载页面。适用于数据仅在 JavaScript 执行后才渲染的场景。 |
构建请求
URL 行
顶部行包含 HTTP 方法(GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS)、目标 URL 和 Send 按钮。Single、Proxy 和 Auto 支持所有方法。Browser 会忽略方法(Chrome 页面导航始终使用 GET)和 body。
请求标签页
在 URL 行下方,五个标签页用于配置其余所有参数:
| 标签页 | 控制内容 |
|---|---|
| UI | 用于设置超时、重定向、标志、proxy、浏览器专属选项以及校验规则的表单字段 |
| Body | 适用于 POST / PUT / PATCH request 的自由格式请求体 |
| Headers | 键值对形式的自定义 request header |
| Cookies | 当前浏览器中按主机维护的 cookie jar。Use jar 会将匹配的 cookie 附加到 request,Save response cookies 会保存 response 设置的 cookie。两者默认均已启用,该标签页会预览此 request 将发送的内容 |
| Raw | 即将发送的完整 JSON payload(附带 Copy JSON 的只读预览),下方包含 cURL 复现命令 |
在 UI / Body / Headers / Cookies 中所做的任何更改都会实时反映在 Raw 中。不能直接在 Raw 中输入内容:请在其他标签页修改 request。包含与引擎默认值不同设置的任何标签页或折叠区块上都会显示红点,方便一眼识别自定义配置。
UI 面板分区
UI 标签页将设置归类到各折叠区块中。留空字段将回退到引擎的 schema 默认值。不适用于当前 Mode 的区块会自动隐藏。
- 超时:
timeout_ms,connect_timeout_ms,accept_timeout_ms,server_response_timeout_ms,dns_cache_timeout_sec。Browser 和 Auto 仅公开timeout_ms(在 Auto 模式下为总预算)。 - 重定向: 切换并设置
followRedirects(0-20)。适用于 Single 和 Proxy。Browser 会自行跟随重定向。 - 标志:
unblocker适用于 Single, Proxy 和 Browser (Browser 上的unblocker会完成页面要求的检查);tryJsonData和returnBuffer适用于 Single 和 Proxy。Auto 改为公开forceProxy和returnSession。 - 代理: 为 Single 或 Browser 选择特定 proxy ID,或者为 Proxy 引擎设置
maxTries, Proxy 外部超时,exitCountries,exitClass和ignoreProxies。Auto 还会公开ignoreProxies和exitClass。exitClass下拉菜单包含三种状态: 未设置则完全不发送该字段,standard指定标准池,premium则允许在标准池受阻时将 request 升级到高级出口。未设置与standard均停留在标准池; 指定类别的成功 request 会返回exitClass。高级池需要包含高级出口的套餐: 参阅 exitClass。 - 浏览器配置文件: 三个级联下拉菜单, os, browser 和 version, 列出 FourA 实际可模拟的选项。它们会显示在 Single 和 Proxy 模式中。留空则使用最新的 Chrome。每个选项都会缩小另外两个的范围, 因此绝不会出现无法解析的组合。该部分需要开启
unblocker: 若将其关闭, 则不会发送任何浏览器 header, 配置文件只会生效一半, 此时 API 会直接拒绝该 request。 - Browser: 仅限浏览器的选项, 例如
checkStatus和checkText。 - 验证: status accept 和 status fail 接收以逗号分隔的状态码 (
validate.status), 而 body accept 和 body fail 接收以|分隔的子字符串候选项 (validate.data)。适用于 Single, Proxy 和 Auto。Browser 改为使用checkStatus和checkText。表单中没有用于 header 规则 (validate.headers) 的字段。
运行返回可用 proxy 后, UI 标签页末尾会显示 Working proxies 部分。它最多列出 20 个 proxy ID, 最新的排在前面, 每个都带有其出口国家和时间。点击 use 可将其填入 Single 或 Browser 的 proxy 字段 (Proxy 引擎会自行查找), 点击 × 则将其从列表中移除。
出口国家限定 (Proxy 模式)
Proxy 上的 exitCountries 字段接受以逗号分隔的两位目标可见国家代码列表 (CZ, GB)。提交时,值会被自动去除空格、转为大写并去重。从标准池中选择时遵循严格的白名单机制:出口未知的 proxy 会被排除,且标准池绝不会回退到其他国家。优质出口也遵循该列表。当 exitClass 设置为 premium 时,优质出口将从所列国家之一发出,若标准池在某国家无可用节点,则会转到该国家的优质出口。在未设置 premium 的情况下,若池中无匹配项,将返回 code: "no_eligible_proxy",并在 details.exitCountries 中返回请求的范围。请保留该范围并稍后重试。
在限定范围的 proxy 调用成功时,响应条会在 proxy ID 旁边显示 exit <CODE>,以便您验证所提供的国家是否与请求一致。
出口位置 (Proxy 模式)
Proxy 上的 Exit location 分组用于选择优质出口的具体发出位置:地区、城市、网络、设备以及其保留该地址的时长。当 exitCountries 仅指定一个国家时,地区、城市和网络列表会自动填充。请将 exitClass 设置为 premium,因为这些选项中的任意一项都会使请求仅通过优质出口发送。应答中的 proxy ID 会保留该位置,因此只需将其传入 Single 或 Browser 即可满足这两者的需求。请参阅 Exit location。
工具栏重置
工具栏上的 Reset 按钮(位于 History 和 Saved 旁边)可将 playground 恢复到初始状态。由于此操作具有破坏性,它会打开一个确认对话框,明确列出将被清除的内容:所有 request 标签页、jar 中保存的所有 cookie、所有携带的 proxy 以及当前 response。已保存的预设和所选的 API key 将被保留。点击 Reset everything 进行确认;进行其他任何操作都将取消。
发送与取消
点击 Send 发送请求。调用进行期间,右侧列会切换为带有加载图标和 Cancel 按钮的 loading 状态。点击 Cancel(或在移动端再次点击该按钮)即可中止。已取消的请求会恢复为带有 "Request canceled." 的空闲占位状态,而不是渲染错误信息。
请求完成(或失败)的瞬间,响应卡片会切换为相应结果。在手机端或任何窄到将响应置于表单下方的窗口中,当响应卡片出现在屏幕下方时,页面会将其滚动到视图中。Auto 运行可能比手动引擎耗时更长,因为针对冷目标的阶梯策略可能会逐级攀升多次。
查看响应
响应列通过其自身的标签页结构镜像了请求布局:
| 标签页 | 显示内容 |
|---|---|
| Body | 解析后的 body。根据返回内容在 JSON、HTML 和 Text 视图之间切换。 |
| Headers | 响应 header,每行一个。 |
| Cookies | 目标返回的 cookie,提供解析视图(按 host 分组)和原始视图(Set-Cookie 文本)。解析视图会在仅限 host 的 cookie 上显示 HO 徽标;domain cookie 则无标记。 |
| Raw | API 返回的完整 JSON envelope。 |
响应工具栏提供了用于整个响应的 Copy 和 Download,以及用于在当前打开的标签页中搜索的 Find in response(Ctrl+K 或 Cmd+K),按 Enter 和 Shift+Enter 可在匹配项之间切换。Body、Headers 和 Cookies 也拥有各自专属于该标签页的 Copy 和 Download。
标签页上方的元数据栏显示上游 HTTP 状态、总耗时、处理调用的 proxy ID,以及(针对限定范围的 Proxy 调用)两位字母的 exit <CODE>。该栏还会显示响应大小,并在 API 报告时显示请求消耗的积分。对于 Auto 运行,阶梯和尝试次数显示在该栏下方的句子中。
调用所需资源
元数据栏下方的句子以文字形式说明了加载页面所用的方式。对于 Auto 运行,它指明了阶梯(FourA 已为该 host 建立的会话、普通 request、轮换 proxy、真实浏览器,或者先使用浏览器随后进行轻量级重放)、是否解决了验证、进行了多少次尝试以及消耗了多少成本。当请求设置了 exitClass 时,它还会指明是由优质出口还是标准池交付的。
当您的方案限额之一拒绝了调用时,该句子会首先说明:"Stopped by your plan, not by the site",随后注明具体超出了哪项限制(今日浏览器请求已用尽、在途请求过多、当前周期积分已耗尽等),并附带指向 Usage & Limits 的链接。该行根据 API 返回的 X-FourA-Limit 代码构建,因此当复杂页面失败时,您能明确是目标站点拦截了请求还是方案限制所致。
在多次运行之间传递值
在任何返回了可重用会话数据的运行后,响应工具栏上的小型 Carry 控件会显示可用项:
- 使用
returnSession执行的 Auto 运行提供该会话的userAgent和proxy。会话 cookie 显示在响应的 Cookies 标签页上,并在启用 Save response cookies 时存入 cookie 存储。 - Browser 运行提供响应
userAgent,若使用了代理,还会包含 proxy ID。 - Proxy 运行提供返回的 proxy ID,并在轮换机制选择了未主动请求的配置时提供浏览器 profile。
点击 Carry 即可一键选择将各个值应用到何处:userAgent 会成为 Single 或 Proxy 上的 User-Agent header,而 proxy ID 会填入 Single 或 Browser 上的 proxy 字段。接收传递值的字段会显示"已修改"红点,以便查看变更内容。
沿用的 browser profile 会填充操作系统、浏览器和版本这三个选择框,并开启 unblocker,这与手动选择配置文件时的规则一致。由于表单包含三个下拉选择框而非单一 ID 字段,因此仅在配置文件目录加载完成后才会提供该选项。
该配置文件是唯一表明成功的请求与你输入的请求不一致的值:Proxy 仅在切换到未要求的浏览器系列时才会报告 profile。如果不包含它进行重放,你重放的将是失败的版本。请参阅 为什么 Proxy 请求用尽了重试次数。
展开至全屏
响应工具栏上的展开图标可将响应卡片从分屏布局中移出,进入全屏覆盖模式。当半角列空间显得局促时,适用于查看深层 JSON 树、长 Set-Cookie 转储或较宽的 HTML 主体。覆盖层打开时,页面本身会暂停滚动。再次点击该图标(或按 Escape 键)即可折叠。
cURL 重现器
在请求的 Raw 标签页下方的 JSON 后,一个 cURL 代码块展示了与你正在构建的请求完全等效的命令行,并附带 Copy curl 按钮。复制它即可在终端重现该请求、分享给团队成员或粘贴到错误报告中。
对于支持显示的密钥,代码片段旁的 Reveal key 按钮可直接在 cURL 中插入真实的明文密钥,方便原样复制运行。再次点击即可隐藏。旧版密钥(在显示功能上线前生成)将保留 PASTE_PLAINTEXT_FOR_<key-name> 占位符;在 API Keys 页面重新生成密钥即可使其可显示。
服务器会对每次密钥显示进行审计日志记录,且明文密钥仅在当前页面会话的内存中保留。
保存预设
如果你需要反复配置同一个目标,可以将其保存。点击请求标签页行的 Save,即可将当前配置存储为命名预设。
打开工具栏中的 Saved 即可查看你的预设。点击 Load 填充表单,或点击 Delete 删除预设。
如果 FourA Chrome 扩展的密钥属于你的账户,从该扩展的 DevTools 标签页打开的请求在加载时会自动选中该密钥,页面也会提示该状态。否则,页面会要求你选择一个密钥。未设置 unblocker 的重放请求在运行时会默认开启它,与 API 逻辑一致。
| 预设字段 | 存储内容 |
|---|---|
| 名称 | 简短标签(最多 100 个字符) |
| 描述 | 可选备注(最多 500 个字符) |
| Endpoint | 预设适用的引擎(auto / single / proxy / browser) |
| Config | 完整的请求载荷,包含 UI 字段、header、cookie 和 body |
预设的作用域限定在你的用户账户内,不会与团队成员共享。
从历史记录重放
你运行的每个请求都会被记录。打开工具栏中的 History 即可查看最近运行的 20 条记录,按时间倒序排列。
每一行显示 endpoint、目标 URL、状态和时间。点击任意行上的 Replay 将该 request 重新加载到表单中,然后点击 Send 再次运行。
历史记录自动限定在您的账户范围内:您只能看到自己的运行记录。
从 Activity 打开
Activity Log 详情对话框中包含一个 Open in Playground 按钮。点击该按钮后,Playground 会同时加载已归档的 request 和已归档的 response。表单将根据存储的 payload 自动填充,response 卡片会显示 API 当时返回的内容,并在 proxy 元数据条上显示“archived”徽标(“archived
在 Playground 中,您可以更改参数并点击 Send 向当前线上 API 发起新的 request,也可以仅检查归档的 payload 而不重新运行。Payload 保留 24 小时,因此较早的 Activity 行将无法重新加载 response。
提示
- 针对新目标编写代码之前,建议先在 Playground 中进行测试。在开启 Auto 的情况下,您可以在几秒钟内确定简单的 fetch 是否足够,或者目标网站是否强制要求浏览器解析。
- 对于有国家或地区限制的目标,在设置了
exitCountries的情况下运行一次 Proxy 调用,然后将返回的 proxy ID 传入 Browser 调用,以便 JavaScript 渲染通过同一个出口进行。 - 为经常抓取的每个目标保存一个 preset。重放保存的 preset 只需一次点击,而凭记忆重新构建 request 会花费更多时间。
- 使用 Cookies 标签页排查基于会话的抓取问题。原始 Set-Cookie 视图会精确显示目标发送的内容。
- 当目标拒绝请求时,在尝试更重的引擎之前,先尝试 Browser profile 下拉菜单中的其他选项。切换呈现的浏览器是免费的,但浏览器渲染不是。
- Playground 的 request 会从您选择的 key 中扣除费用。如果您希望保持生产环境用量数据整洁,请使用专用的低配额 key 进行临时调试。
相关内容
- API Endpoints:全部四种引擎的完整参数参考,包括
exitCountries和浏览器 profile 字段 - Smart Fetch (Auto):Auto 的底层运行机制
- Choosing the Right Endpoint:如何在 Auto、Single、Proxy 与 Browser 之间进行选择
- API Keys:管理用于验证 Playground 请求的 key
- Activity Log:直接在 Playground 中打开历史 request
- Dashboard Overview:所有侧边栏分区