echolot send

echolot send sendet eine Anfrage und schreibt den Body der Antwort in die Standardausgabe. Gib ihm eine URL, wie du sie curl gibst, oder den Pfad einer gesicherten Anfrage in einem Arbeitsbereich, die es sendet wie die App: mit Variablen, Auth, Skripten und Prüfungen. Es öffnet auch WebSocket- und Socket.IO-Sitzungen und hört Event-Streams ab.

echolot send [<options>] <url>

<url> ist eine URL oder der Pfad einer gesicherten Anfragedatei (.req.toml, .gql.toml oder .mcp.toml) im Ordner requests eines Arbeitsbereichs.

Eine URL sendenCopy Anchor Link

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

Der Body geht in die Standardausgabe, sodass du ihn weiterreichen (| jq .) oder mit -o in eine Datei schreiben kannst. Sonst wird nichts ausgegeben, solange du nicht darum bittest:

• -i gibt vor dem Body die Statuszeile und die Header aus.
• -v gibt die Zeiten in die Standardfehlerausgabe aus: DNS, Verbindung, TLS, Warten und Übertragung, Größe und Hash des Bodys, die Remote-Adresse, die TLS-Version, das gewählte Protokoll und die Zertifikate des Servers. Ein dekodierter Body (gzip, Brotli, zstd) zeigt seine Größe davor und danach.
• --wire gibt die genauen gesendeten und empfangenen Bytes, wie auf der Leitung mitgeschnitten, in die Standardfehlerausgabe aus.

Mit einem Body und Headern:

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 behält die Reihenfolge und die Schreibweise deiner Header bei. --data-file streamt den Body aus einer Datei, statt ihn in den Speicher zu lesen, und eignet sich daher für große Uploads. --raw sendet keine Header, die du nicht geschrieben hast: kein Host, kein Content-Length, kein Accept-Encoding.

Eine gesicherte Anfrage sendenCopy Anchor Link

Gib den Pfad einer Anfragedatei an. Echolot findet den Arbeitsbereich darum herum, löst {{variables}} mit der Umgebung auf, die du wählst, führt die Skripte und Prüfungen der Anfrage aus und gibt die Ergebnisse aus:

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 oder --env staging löst mit der Umgebung in environments/staging.toml auf.
• Geheime Variablen kommen aus ECHOLOT_SECRET_<NAME>-Variablen oder auf einem Mac aus dem Schlüsselbund. Siehe Secrets.
• Was die Skripte protokollieren, erscheint unter ── console ──, Prüfungen und pm.test-Ergebnisse unter ── tests ──, in der Standardfehlerausgabe. Eine fehlgeschlagene Prüfung setzt den Exit-Code auf 1.
• Eine Variable, die sich nicht auflöst, wird als Warnung ausgegeben, bevor die Anfrage hinausgeht.
• -X, -H, -d und --data-file sind für URLs; eine gesicherte Anfrage sendet, was ihre Datei sagt. --timeout, --http1.1, --http2, --http3, --raw, -k, --listen, die Proxy- und die Zertifikat-Optionen gelten für beide.

Event-Streams, WebSocket und Socket.IOCopy Anchor Link

Server-Sent Events. Eine Antwort mit text/event-stream wird, sobald sie eintrifft, in die Standardausgabe gestreamt. --listen gibt an, wie lange zugehört wird: standardmäßig 10 Sekunden, bei 0 so lange, bis der Server den Stream beendet.

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

WebSocket. Eine URL mit ws:// oder wss:// öffnet eine Sitzung. Jede Zeile, die du tippst (oder einspeist), und -d wird als Textnachricht gesendet; eintreffende Nachrichten werden eine pro Zeile ausgegeben, binäre in Base64. Endet die Eingabe, hört Echolot --listen Sekunden lang zu und schließt dann. --subprotocol bietet ein Subprotokoll an und kann mehrfach angegeben werden. -i oder -v gibt die Upgrade-Antwort in die Standardfehlerausgabe aus.

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

Socket.IO. --socketio spricht Socket.IO über eine URL mit http(s):// oder ws(s)://. Jede Eingabezeile ist ein Ereignis: sein Name, dann seine JSON-Argumente (chat {"text": "hi"}; ein Array sind mehrere Argumente). Ereignisse werden als name [arguments] ausgegeben, Bestätigungen als ack id [arguments].

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

Unter Socket.IO-Anfragen findest du Server, an denen du das ausprobieren kannst.

OptionenCopy Anchor Link

Ohne --http1.1, --http2 oder --http3 wählt Echolot die Version, wie es die Einstellung Automatisch der App tut. Wähle nur eine davon.

Exit-CodesCopy Anchor Link

Ein Skript vor der Anfrage, das pm.execution.skipRequest() aufruft, sendet nichts und endet mit 0.