echolot send

echolot send は1つのリクエストを送信し、レスポンスのボディを標準出力に書き出します。curlと同じようにURLを指定するか、ワークスペース内の保存済みリクエストのパスを指定します。 保存済みリクエストはアプリと同じように送信され、変数、認証、スクリプト、チェックも含まれます。WebSocketとSocket.IOのセッションを開いたり、イベントストリームを待ち受けたりすることもできます。

echolot send [<options>] <url>

<url> は、URLか、ワークスペースの requests フォルダ内にある保存済みリクエストファイル（.req.toml、.gql.toml、.mcp.toml）のパスです。

URLを送信するCopy 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

Server-Sent Events。 text/event-stream のレスポンスは、届いたそばから標準出力にストリーミングされます。--listen は待ち受ける時間を指定します。 デフォルトは10秒で、0 はサーバがストリームを終了するまで待ち受けます。

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

WebSocket。 ws:// または wss:// のURLを指定すると、セッションが開きます。入力した（またはパイプで渡した）各行と -d は、テキストメッセージとして送信されます。 届いたメッセージは1行ずつ出力され、バイナリのものは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を使います。入力の各行は1つのイベントで、イベント名に続いて 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はアプリの自動設定と同じようにバージョンを選びます。 これらのうち指定できるのは1つだけです。

終了コードCopy Anchor Link

pm.execution.skipRequest() を呼び出すリクエスト前スクリプトがある場合、何も送信せず、終了コード0で終了します。