# Playground：在控制台中构建和测试请求

> URL: https://foura.ai/zh/blog/dashboard-playground
> Updated: 2026-05-28
> Index: https://foura.ai/llms.txt

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 复现命令：

```bash
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，我们从中分析趋势。
