echolot send

echolot send 发送一个请求，并将响应正文写入标准输出。你可以像给 curl 那样给它一个 URL，也可以给它工作区中存储的请求的路径，它会像 App 那样发送： 包括变量、认证、脚本和检查。它还能打开 WebSocket 和 Socket.IO 会话，并监听事件流。

echolot send [<options>] <url>

<url> 是一个 URL，或工作区的 requests 文件夹中存储的请求文件（.req.toml、.gql.toml 或 .mcp.toml）的路径。

发送 URLCopy Anchor Link

echolot send https://demo.echolot.dev/v1/products/TNT-MH-2P

正文输出到标准输出，所以你可以通过管道传给其他命令（| jq .），或用 -o 写入文件。除非你要求，否则不会打印其他内容：

• -i 在正文之前打印状态行和标头。
• -v 将耗时打印到标准错误：DNS、连接、TLS、等待和传输，以及正文的大小和哈希、远程地址、TLS 版本、选用的协议和服务器的证书。解码过的正文（gzip、Brotli、zstd）会显示解码前后的大小。
• --wire 将按传输捕获到的、实际发送和接收的字节打印到标准错误。

带正文和标头的请求：

echolot send https://demo.echolot.dev/echo/anything -X POST \
  -H 'Content-Type: application/json' \
  -d '{"sku": "TNT-MH-2P"}' -v

── body ── decoded zstd 257 → 418 bytes
── timing ──
DNS          79.61 ms
Connect      15.65 ms
TLS          28.70 ms
Waiting      19.75 ms
Transfer      0.53 ms
Total       146.36 ms
Body      418 bytes, sha256 01facf0b2388ca67…
Remote    [2606:4700:3031::6815:3cf1]:443
── tls ── TLS 1.3, ALPN h2
CN=echolot.dev
  issuer CN=WE1,O=Google Trust Services,C=US, valid until 30 Jan 2027
Alt-Svc   the server offers HTTP/3 (h3 on port 443); --http3 uses it, and so do later requests on Automatic in the same run

-H 会保留你的标头的顺序和大小写。--data-file 从文件中以流的方式发送正文，而不是读入内存，因此适用于大文件上传。--raw 不发送任何你没写的标头：没有 Host、 没有 Content-Length、没有 Accept-Encoding。

发送存储的请求Copy Anchor Link

给出请求文件的路径。Echolot 会找到它所在的工作区，用你选取的环境解析 {{variables}}，运行请求的脚本和检查，并打印结果：

echolot send Alpenglow.echolot/requests/catalog/get-product.req.toml -i

HTTP/2 200 OK
content-type: application/json; charset=utf-8
etag: W/"TNT-MH-2P-1"
…

{
  "sku": "TNT-MH-2P",
  "name": "Matterhorn 2P Tent",
  …
}
── tests ──
✓ Status equals 200
✓ JSON value $.sku equals {{productId}}
2 passed

• -e staging 或 --env staging 使用 environments/staging.toml 中的环境来解析。
• 机密变量来自 ECHOLOT_SECRET_<NAME> 变量，在 Mac 上也可来自钥匙串。参见机密。
• 脚本记录的内容显示在 ── console ── 下，检查和 pm.test 的结果显示在 ── tests ── 下，均输出到标准错误。检查失败会使退出码为 1。
• 无法解析的变量会在请求发出之前作为警告打印。
• -X、-H、-d 和 --data-file 用于 URL；存储的请求则发送其文件中写明的内容。--timeout、--http1.1、--http2、--http3、--raw、-k、--listen、代理和证书选项对两者都适用。

事件流、WebSocket 和 Socket.IOCopy Anchor Link

服务器发送事件。 text/event-stream 响应会在到达时以流的方式输出到标准输出。--listen 指定监听多久：默认 10 秒，0 表示一直监听到服务器结束该流。

echolot send https://demo.echolot.dev/v1/orders/events --listen 0

WebSocket。 ws:// 或 wss:// URL 会打开一个会话。你输入（或通过管道传入）的每一行，以及 -d，都会作为文本消息发送；到达的消息每条打印一行，二进制消息以 Base64 打印。 输入结束后，Echolot 会监听 --listen 秒，然后关闭。--subprotocol 提供一个子协议，可以给出多次。-i 或 -v 会将升级响应打印到标准错误。

echo '{"op": "subscribe", "channel": "orders"}' | echolot send wss://demo.echolot.dev/v1/orders --listen 5

Socket.IO。 --socketio 在 http(s):// 或 ws(s):// URL 上使用 Socket.IO。每个输入行是一个事件：先是它的名称，然后是它的 JSON 参数（chat {"text": "hi"}；数组表示多个参数）。 事件以 name [arguments] 打印，确认以 ack id [arguments] 打印。

echolot send http://localhost:3001 --socketio --namespace /support --auth '{"token": "demo"}'

可以拿来试验的服务器，参见 Socket.IO 请求。

选项Copy Anchor Link

不带 --http1.1、--http2 或 --http3 时，Echolot 选取版本的方式与 App 的自动设置相同。这几个选项只能选一个。

退出码Copy Anchor Link

调用 pm.execution.skipRequest() 的预请求脚本不会发送任何内容，并以 0 退出。