Playground 现已在您的 Dashboard 中上线。三个 endpoint,一个 cookie jar,解析全部 header。选择 Single、Proxy 或 Browser,填写 request,点击 Send。response 会直接显示在同一屏幕中,包含 status、headers、body 以及解析后的 cookies。确认无误后,将可运行的 curl 复制到代码中即可。
这不是独立页面,也不是部署在其他 URL 后面的沙盒。它使用您的真实 key 直接请求生产环境 API。您在 Playground 中看到的内容,就是生产环境代码将获得的结果。
工作原理
登录 Dashboard,选择三个 endpoint 之一,表单会自动调整,仅显示该 endpoint 实际接受的字段。
- Single 包含
url、method、headers、unblocker、proxy、tryJsonData、followRedirects以及 timeout 配置项。 - Proxy 在
request块下包含相同的配置集,外加 proxy 选择过滤器(country、city、ASN、anonymity、freshness)。 - Browser 包含
url、cookies、headers以及等待条件。
点击 Send 时,Dashboard 会针对您的账户验证调用,并 POST 到 api.foura.ai 上的 /api/{endpoint}。您的真实 API key 绝不会经过页面传输。Playground 是 Dashboard 中唯一可以在不暴露浏览器端 key 的情况下发起计费 request 的地方。
以下是 Playground 为基础 Single request 生成的 curl 复现命令:
curl -X POST 'https://api.foura.ai/api/single' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
--data-raw '{
"url": "https://example.com/products",
"method": "GET",
"unblocker": true,
"tryJsonData": true
}'
将其粘贴到终端或构建脚本中,其行为与 Send 按钮完全一致。我们不会将 payload 封装在自定义外层中,也不会重命名任何字段。Playground 发送的内容就是 API 接收的内容,仅此而已。
返回内容展示
响应面板会显示上游状态、总耗时,以及(针对 Proxy 调用)处理该请求的 proxy id。Body、Headers 和 Cookies 均有独立标签页。
Body。 自动识别的 JSON 会在可折叠视图中渲染。HTML payload 会切换到预览窗格,方便直接查看目标站点返回的内容。纯文本则显示为等宽文本视图。Body 和 Raw 面板均配备支持上一处/下一处跳转的搜索框。
Headers。 解析视图中每个 name: value 占一行,或通过 Raw 查看完整的多跳响应链。每次重定向都会保留自己的 header 集合,点击一次即可追踪 302 重定向至最终目的地。
Cookies。 cookie jar 会解析响应中的每一行 Set-Cookie,跟踪每个 cookie 是仅限主机还是全域名生效(RFC 6265 §5.3),并提供两种视图:按主机划分的可折叠卡片或原始列表。开启 jar 开关,下一次请求会自动带上匹配的 cookie。对于 Single 和 Proxy,这意味着在发出的请求中添加 Cookie header。对于 Browser,这意味着将 cookie 数组附加到请求对象上。
预设功能可将整个请求配置保存在指定名称和描述下,方便随时切回“在 staging 环境测试登录”而无需重新构建配置。历史记录会保留最近 20 次运行的状态、content type、总耗时及所使用的 proxy。
实际影响
Playground 真正改变的是迭代循环。
以前,你需要编写一个微型脚本(Node、Python 或 shell),配置好 key,调用 API,打印 body,调整一个 header,然后再运行一次。从“我想看看这个站点返回什么”到得出结果,可能需要十分钟。
在 Playground 中,这个闭环缩短到了大约 15 秒。点击 endpoint,粘贴 URL,点击 Send,查看 cookie,将 unblocker 从 off 改为 on,再次点击 Send。在你打开编辑器的时间里,你已经清楚哪种请求版本在目标站点上有效。
我们推出 Playground 并不是为了替代你的实际代码。我们推出它是为了让“这个站点到底能不能做”到“可以,这是能跑通的 curl”之间的过程,不再需要大费周章地写临时脚本。
高级用户指南
界面上未直观展示的几个特性:
预设包含完整的 payload。 这包括超时组、验证规则、重定向限制以及所有自定义 header。保存预设时,你保存的是已验证请求的快照,而不仅仅是 URL。在跨 endpoint 维护一组稳定的冒烟测试时非常有用。
cookie jar 基于会话独立存在。 它保留在你的浏览器中。我们不会在服务端持久化捕获的 cookie。如果需要完全重置状态,硬刷新标签页即可。
Raw 选项卡与表单实时同步。 表单字段渲染的内容与 Raw 选项卡展示的 JSON 完全一致。将 payload 粘贴至 Raw,表单便会自动填充还原。同事可以在聊天中直接分享可用的 request,你只需粘贴到 Raw,表单就会自动就绪。
Browser cookie 采用对象格式,而非 header 字符串格式。 如果你手动向 Browser endpoint 发送 cookie,每个条目都需要符合 {name, value, domain?, path?, httpOnly?, secure?, sameSite?} 规范。开启 cookie jar 时,Playground 会自动正确构建它们。如果是自行构造,则必须确保 schema 匹配。
执行结果会显示在活动日志中。 Playground 发起的 request 与其他通过你的 key 进行的调用完全一致。你可以在活动日志中看到对应记录,并带有清晰的结果标记(success、client_error、application_error、rate_limit、service_error)。这对于复现不稳定的生产调用非常有用:在 Playground 中重试,从活动日志中检索,然后直接将链接分享给团队。
后续规划
Playground 只是第一步,我们正全力让 Dashboard 不仅仅用于展示历史调用。我们在 request 日志中观察到的模式,将直接决定下一阶段交付的功能。
如果你在日常使用中发现任何异常,无论是字段与文档不符、cookie 未在重定向中保留,还是 response 渲染错误,这些都是我们最高优先级关注的反馈。Dashboard 记录 request,我们从中分析趋势。