快速上手 · 三步发出第一个请求
目标:从零建一个能发出去的 HTTP 请求。理解「分组 → 环境 → 请求」这条主线后,其余协议只是换协议、换前置 URL。
第 1 步:建分组、绑环境
快速请求里,环境绑在分组上,同组所有请求共享它。
- 新建一个分组(例如
我的第一个组)。 - 给这个分组绑定一个环境。若还没有环境,先新建环境(例如
本地)。
为什么要绕这一层?因为一个业务模块在开发/测试/生产之间切换时,你只想改「环境」这一处,而不动几十个请求。
第 2 步:在环境里填「前置 URL」
一个环境为每种协议各准备一条基址。发 HTTP,就填 http 那条:
| 协议线 | 示例基址 | 说明 |
|---|---|---|
| HTTP | http://127.0.0.1:18080 | 用 https:// 即走 TLS |
| WebSocket | ws://127.0.0.1:18085 | 用 wss:// 即走 TLS |
| gRPC | grpc://127.0.0.1:18089 | 用 grpcs:// 即走 TLS |
| MQTT | mqtt://127.0.0.1:18884 | 用 mqtts:// 即走 TLS |
⚠️ 最容易踩的坑:每条基址到底算哪种协议,看 URL 开头的 scheme,而不是你填在哪一行。比如 WebSocket 的基址必须写成
ws://…或wss://…;若手滑写成https://…,它会被当成 HTTP,WebSocket 请求就找不到基址、发送失败。让协议行和 scheme 保持一致。
(这里的 18080 等端口来自示例测试服务端;连你自己的接口时把它换成真实地址即可。)
第 3 步:建请求、只填路径片段、发送
在分组下新建请求:
- 协议选 HTTP,方法选
GET。 - URL 只填路径片段:
/echo(不是完整域名——域名已由环境的http前置 URL 承担)。 - 点发送。
你会看到 /echo 把你发出去的东西原样回显回来。装配时它其实发的是 http://127.0.0.1:18080/echo。