OpnForm：实践指南
2026-09-12 3466078
2026-09-13 0
实际看Swell，先要确认它的用途：Swell：API 开发工具，使开发人员能够测试通过流技术提供服务的端点，包括服务器发送事件 (SSE)、WebSockets、HTTP2、GraphQL、gRPC 和tRPC..。软件开发里，依赖、接口和异常处理往往比主路径更影响采用。我会在隔离分支完成一个可回滚的小任务，检查安装步骤、接口契约、测试结果和错误信息。它适合需要可检查开发流程而非单次演示的工程师；采用前仍要看维护状态和试跑结果。
膨胀
Swell 是一款 API 开发工具，使开发人员能够测试 HTTP2、GraphQL 端点以及通过流技术提供服务的端点，包括服务器发送事件 (SSE)、WebSockets、gRPC、 WebRTC 和 OpenAPI。
开始使用
访问 www.getswell.io 下载最新版本。
Swell 适用于 OSX、Linux 和 Windows。
亮点
Swell 是发送和监控 API 请求的一站式商店：
考虑在未来迭代 Swell？
我们强烈建议您查看 docs 文件夹中的 DEV-README.md。我们提供了有关最新更新的综合指南、哪些领域将受益于未来的迭代以及核心组件的详细信息。
核心特点
HTTP2：Swell 支持请求和响应的完整 HTTP2 复用。 HTTP 对同一主机的请求将通过同一连接发送。默认情况下，Swell 将尝试为所有 HTTPS 请求启动 HTTP2 连接，并能够针对旧服务器恢复到 HTTP1.1。每个连接允许多个并发流。
GraphQL：Swell 完全支持 GraphQL 的所有三种根类型 - 查询、突变和订阅 - 以及内省。还支持变量，使创建查询变得容易。
服务器发送的事件 (SSE)：由一个简单的切换框启动，Swell 在 SSE 事件进入时一一显示它们。与 HTTP2 流类似，SSE 允许多个打开的连接流。
WebSockets (WS)：Swell 支持通过 HTTP 握手直接连接到 WebSocket 服务器，开发人员能够直接向连接的 WS 服务器发送消息。所有发出和传入的消息都会实时显示。
gRPC：Swell 完全支持 gRPC 的所有四种流类型 - 一元、客户端流、服务器流、双向流。
tRPC：Swell 完全支持 TypeScript 远程过程调用的所有方法，包括对查询、突变以及订阅的批量调用支持
当前正在使用 http get 和 post 请求使用 TRPC 的 http RPC 规范进行调用（请参阅 RPC 文档）。 TLDR-查询过程的输入将转换为 uri 编码的 json 字符串并作为查询参数发送，而 mutate 过程的输入将存储在主体内部。
批量请求可以通过在发送请求之前添加多个过程来进行，所有查询过程将一起批处理为一个单独的 get 请求，所有 mutate 过程将一起批处理为一个单独的 put 请求，如果一个请求中混合有查询和 mutate 过程调用，应用程序将同时发出 post 和 get 请求，并将响应合并为一个响应。
嵌套端点必须遵循通用格式 parentEndpoint.childEndpoint.grandchildEndpoint。例如：
client.user.update.mutate({ userId: '1', name: 'Luke' });
对上述端点的请求必须从下拉菜单中选择 mutate 选项，端点必须为 .user.update，输入正文为 {"userId": "1","name": "Luke"}
有关发送 tRPC 请求或设置 tRPC 服务器的更多信息，请参阅 tRPC 文档。
WebRTC：Swell 可以轻松测试 WebRTC 应用程序的视频、音频和文本通道。目前Swell支持手动录入SDPs。
使用应用程序生成的报价和答案设置文本通道连接的演练：
附加功能
HTTP/2 和 GraphQL 的压力测试：使用 Swell 的压力测试功能测试您的服务器后端，以确保您的服务器能够相应地管理预期和意外负载
直接向端点发送请求：您可以立即向端点 OR 发送请求，在工作区中暂存请求以进行多级测试。
Swell 中的脚本：如果您喜欢测试驱动开发，Swell 允许您编写断言测试来帮助定义和测试后端 API 服务。
工作空间：Swell 允许您保存工作空间，以便更轻松地测试多个请求。
预览：您现在可以查看某些 API 响应的渲染预览 (HTML)
Collection Runner：您还可以在工作区中暂存请求并自动发送每个请求的过程。无需在每一个上手动按发送；相反，每个请求都会按照暂存的顺序触发。
文件 Upload/Dark 模式：如果单击正文下拉菜单，则可以选择二进制，这允许您上传可与任何请求一起发送的文件，以测试后端文件上传路由。此外，您可以通过右上角的按钮切换黑暗模式。
实验特点
Mock Server：Swell 允许您创建自己的 HTTP/2 模拟服务器，以方便前端开发，而无需依赖于完全构建的后端服务器。
Webhooks：Swell 包含用户定义的 HTTP 回调连接测试，旨在测试其他服务器与 Web 的连接以及发送数据的能力。该测试确保当事件发生时，源站点向为 Webhook 配置的 URL 发出 HTTP 请求。
OpenAPI：Swell 支持枚举和执行 REST 和 RPC API 请求，如用户提供的 OpenAPI 文档中定义的那样。
内置